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PREFACE 


This manual describes how to use the iAP X 86,88 Family utilities: 


e LINK86 
¢ CREF86 
e §6LIB86 

e LOC86 
¢ OH86 


These products run on 8086- and 8088-based systems. They are used by program- 
mers developing programs with ASM86, ASM89, PL/M-86, PASCAL-86, 
FORTRAN-86, or any other language translator that produces object code compat- 
ible with the iAPX 86,88 Family of processors. The iAPX 86,88 Family of pro- 
cessors inlcudes 8086, 8088, 8087, and 8089 processor chips. Because the 8086 is the 
first member of this family, this manual uses 8086 generically to represent the entire 
family. 


This manual presumes familiarity with the conventions of the operating system 
under which the iAPX 86,88 utilities are being executed. It also presumes familiarity 
with the basic requirements of individual languages and translators. 


This manual is divided into the following chapters: 


e Chapter 1, Introduction: a summary of the relationship among the utilities and 
basic concepts governing their use 


e Chapter 2, LINK86: how to invoke, use the controls for, and read the printed 
listing from LINK86 


e Chapter 3, CREF86: how to invoke, use the controls for, and read the output 
listing from CREF86 


e Chapter 4, LIB86: how to invoke and use the commands for LIB86 


e Chapter 5, LOC86: how to invoke, use the controls for, and read the printed 
listing from LOC86 


e Chapter 6, OH86: how to invoke OH86 


This manual also contains several appendixes, meant for auce access to the follow- 
ing information: 


e iAPX 86,88 absolute object file format definitions (Appendix A) 
e Hexadecimal-decimal conversion information (Appendix B) 


e The effect of available memory on the posenane of LINK86, CREF86, 
LIB86, and LOC86 (Appendix C) 


e Summaries of iAPX 86,88 Family utility controls and error messages: 
e LINK86 (Appendix D) 
e CREF86 (Appendix E) 
e LIB86 (Appendix F) 
e LOC86 (Appendix G) 
e OH86 (Appendix H) 
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e Additional information for Series III users (Appendix I). This appendix 
addresses issues specific to the Intellec Series III Microcomputer Development 
System, such as operating system dependencies and related publications. 


NOTE 


Appendix I contains pages with Series III-specific sample invoca- 
tions for all the iAPX 86,88 Family utilities controls and 
commands. These pages are foldout pages, designed to be opened 
out to your right and used in conjunction with general instructions 
provided in the chapters and other appendixes. 


Once you have gained sufficient familiarity with the basic principles of iAPX 86,88 
Family utilities operation, you will find the following publication convenient for 
quick syntax reference: 


e iAPX 86,88 Family Utilities Pocket Reference, order number 121669. 


Before reading this manual, ensure that you are familiar with the following terms 


and conventions. 


Notational Conventions 


punctuation 


{} 


L | 


UPPERCASE 


italic 


pathname 


directory-name 


other than the following must be entered if required by the 
control syntax. 


indicates that one and only one of the syntactic items 
contained within the braces is required. 


indicates that the syntactic item or items contained within the 
brackets are optional. 


indicates that the preceding syntactic item may be repeated an 
indefinite number of times (the ellipsis is often used within 
brackets and with a comma “‘[,...]’’ to indicate that preceding 
item may be repeated, but each repetition must be separated 
by acomma) 


vertical bar separates various options within the brackets [ |] 
or braces {}. 


indicates that these characters must be entered exactly as 
shown. 


indicates a meta symbol which may be replaced with an item 
that fulfills the rules for that symbol. The actual symbol may 
be any of the following: 


is a valid designation for a file; in its entirety, it consists of a 
directory-name and a filename. 


is that portion of a pathname which acts as a file locator by 
identifying the device and/or directory containing the 
filename. 


filename 


minimum-size 
maximum-size 
paragraph 
offset 
address 


segment name 
module name 
class name 
group name 
overlay name 
public symbol 
variable name 


Dlack 
system-id 
pathname?, 


pathname2, ... 


Vx.y 


is a valid name for the part of a pathname which names a file. 


are numbers and must follow Intel standards for number 


Tepresentation (see PL/M-86 or ASM86). Use the H suffix for 


hexadecimal, B suffix for binary, O or Q suffix for octal and 
D or nothing for decimal. 


are defined by the 8086 object file formats described in 
Appendix A. They may be up to forty characters 
long and may contain any of the following characters in any 
order: 


A, B, C, D, E, F, G, H, I, J, K, L, M, N, O, P, Q,R,S,T, U, V, 
W, X, Y, Z, 0, be 2s 3, 4, 5, 6,7; 8, 9, 7, @, oy °“7——? 


black background is used in examples to indicate the user’s 
entries. 


is a generic label placed on sample listings where an operating 
system-dependent name would actually be printed. 


are generic labels placed on sample listings where one or more 
user-specified pathnames would actually be printed. 


is a generic label placed on sample listings where the version 
number of the product that produced the listing would 
actually be printed. 
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CHAPTER 1 


INTRODUCTION 


Program Development 


Program development is a process of varying complexity. The complexity depends 
on the language used to develop code, the complexity of the end product, and the 
tools chosen. 


Figure 1-1 shows the development process and the tools available for development 
of an iAPX86,88 Family-based product. 


The tools described in this manual are: 


LINK86, which is a linkage and binding tool 


CREF86, which provides a cross-reference of information on symbols in several 
modules 


LIB86, which is the librarian function for 8086 object modules 
LOC86, which is the relocation tool 


OH86, which converts 8086 absolute object information to the hexadecimal 
format 


LTL 
WITH BIND OBJECT 
MODULE 


ABSOLUTE 
OBJECT 
MODULE 


Figure 1-1. The iAPX86,88 Family Development Process 


ABSOLUTE 
HEX FILE 
** HEX” 


IN-CIRCUIT # 
EMULATOR ! 


121616-1 


1-1 


Introduction iAPX 86,88 Family Utilities 


Overview of the Utilities 


ASM86, ASM89, PL/M-86, PASCAL-86, FORTRAN-86, and other translators as 
well as LINK86 and LOC86 produce 8086 object modules. The language translators 
produce 8086 relocatable object modules that must usually be processed by utilities 
before execution. (Under certain circumstances the translators can produce absolute 
object modules, but this is rare and does not contribute to modular design.) LINK86 
combines 8086 object modules, and LOC86 converts relocatable object modules into 
absolute object modules. QH86 converts 8086 absolute object modules to 8086 hexa- 
decimal format. 


LINK86 combines a list of 8086 object modules into a single object module and 
attempts to match all external symbol declarations with their public symbol defini- 
tions in library modules. (LIB86 is the utility used to create and maintain program 
libraries.) The output of LINK86 is a relocatable object module. However, when 
specified in the controls, LINK86 produces a load-time-locatable (LTL) object 
module; an LTL module can be executed on an 8086-based system. (See the descrip- 
tion of LTL modules later in this chapter.) Whether the LINK86 output is an LTL or 
a relocatable object module, it can serve as input to LOC86. 


CREF86 provides a means for producing a cross-reference listing of public and 
external symbols in multiple 8086 object modules. The object modules may include 
library modules. The output produced by CREF86 should help the programmer to 
identify how symbols will be resolved by LINK86, given the same input files. 


LOC86 converts relocatable (or LTL) object modules to absolute object modules. 
Absolute object modules contain references that require the module segments to be 
placed at particular places in 8086 memory. 


The sequence in which the segments in the input modules are combined and absolute ° 
addresses assigned to segments is determined by the controls supplied and the order 
in which the modules are listed in the LINK86 and LOC86 invocations. 


External References and Public Symbols 


An address field that refers to a location in a different object module is called an 
external reference. An external reference differs from a relative address because the 
translator that generates the modules knows nothing about the location of the 
referenced symbol. You must declare these references as external when coding a pro- 
gram. This tells the translator, and subsequently the relocation and linkage (R&L) 
utilities, that the target of the reference is in a different module. 


A module that contains external references is called an unsatisfied module. To 
satisfy the module, a module with a public symbol that matches the external symbol 
must be found. Associated with a public symbol in a module is an address that 
allows other modules, with the appropriate external reference, to reference the 
module with the public symbol. You must define these symbols as public when 
coding the program. This tells the source translator and the R&L utilities that other 
modules can reference the symbol. 


If there are external references that are not satisfied by public symbols, warning 
messages are issued and the resulting module remains unsatisfied. 
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iAPX 86,88 Family Utilities Introduction 


Use of Libraries 


Libraries aid in the job of building programs. The library manager program, LIB86, 
creates and maintains files containing object modules. 


LINK86 and CREF86 treat library files in a special manner. If you specify a library 
file in the input to these utilities, they search the library for modules that satisfy 
unresolved external references in the input modules already read. This means that 
libraries should be specified after the input modules that contain external references. 
If a module included from the library has an external reference, the library is 
searched again to try to satisfy the reference. This process continues until all external 
references have been the subject of a search of all public symbols in the library 
modules. 


When LINK86 and CREF86 search a library, they normally include only library 
modules that satisfy external references in the output. If no external references are 
satisfied by a library, no modules from the library are included in the LINK86 out- 
put module or the CREF86 output listing. However, LINK86 and CREF86 provide 
the means to unconditionally include a library module even if there is no external 
reference to it. Figure 1-2 shows LINK86 handling of a library file. 


INPUTS 
MoD1 
EXT. REF. C 
EXT. REF. G 
MoD2 
EXT. REF. C OUTPUT 
MODULE 
MOD3 EXT. REF.C 
EXT. REF. G 
EXT. REF. X 
LIBRARY LINK 86 | ner. 6 | 
EXT. REF. X 


(UNRESOLVED) 


PUBLIC C 
PUBLIC G 


MODG 


Figure 1-2. Library Linkage by LINK86 121616-2 
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Introduction iAPX 86,88 Family Utilities 


Relative Addressing 


The relative addresses of instructions and data in program modules are assigned by 
the source translator. The addresses are relative to the beginning of the segment in 
which they reside. The relative address is actually the number of bytes from the 
beginning of the segment. 


After LINK86 combines all the input segments, LOC86 can be used to assign 
absolute memory addresses to all relative addresses. The resulting output module 
can only be executed when its segments are loaded at the absolute addresses assigned 
by the command. If LINK86 is used to create a bound object module, LOC86 is not 
needed to execute the program. 


The LINK86/LOC86 Process 


Although controls are not required for LINK86 and LOC86 execution, the com- 
mands invoking them may contain controls that affect their output. The controls 
make it possible to change the defaults for module combination, address assign- 
ment, and output information. 


The inputs are object modules in disk files. The input modules can contain relative 
addresses, absolute addresses, external references, and public symbols. The input 
modules must be in the 8086 object module format such as is generated by 8086 
translators and LINK86 and LOC86 themselves. 


LINK86 combines segments from the input modules, and for LTL object modules 
LINK86 orders segments in groups and assigns offsets. LOC86 orders the segments 
and assigns absolute addresses according to the controls specified with the command 
and/or the default algorithms. Both commands output the module when processing 
is completed along with any error messages and diagnostic information. Figure 1-3 
shows the LINK86/LOC86 process. 


LINK86 LOC86 


INPUTS OUTPUTS/ INPUT 


LINK8&6 
COMMAND 


CONTROLS 


LINK86 


LOC86 
COMMAND 


AND 
CONTROLS 


ABSOLUTE 
MODULES 


RELOCATABLE 
MODULES 


PUBLIC SYMBOL 
EXTERNAL 
REFERENCES 


LOCATED 
ABSOLUTE 
OBJECT 
MODULE 


LTL 
OR 
LINKED 


OBJECT 
MODULE 


ERROR ERROR 
MESSAGES MESSAGES 
DIAGNOSTIC DIAGNOSTIC 
INFORMATION INFORMATION 


Figure 1-3. The LINK86/LOC86 Process 121616-3 


ON 
8086-BASED 
SYSTEM 


LIBRARIES 
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iAPX 86,88 Family Utilities Introduction 


An 8086 Overview 


To use the R&L commands you must have an understanding of the following 
concepts: 


e Addresses, given as offsets into segments, which must be translated into 
absolute memory addresses, or base offsets 


e Segment definitions, which identify contiguous pieces of information, usually 
code or data 


e Class definitions, which identify segments that share common attributes and 
should be kept together 


e Group definitions, which identify segments that must be kept within a 64K byte 
range of memory 


e Overlay definitions, which identify modules that will be loaded in memory at 
different times during execution. 


¢ Load-time-locatable object modules 


Memory 


The 8086 can address up to a maximum of a megabyte of memory. In decimal a 
megabyte is 1,048,576 bytes. Memory addresses are always shown in hexadecimal. A 
megabyte of memory has the addresses: OH through OFFFFFH. 


Not all 8086-based systems will have a full megabyte of memory. Many systems will 
have gaps in the memory that is available. The different portions of memory will 
probably be implemented with different types of memory chips. The system monitor 
or supervisor is usually stored in ROM or PROM chips. Because it is not modified 
by execution it can be a permanent part of the system. This prevents the need to load 
it each time the system is turned on. The data that is referenced often is kept in high- 
speed RAM because it is modified frequently. It may be practical to keep data that is 
referenced less often in slower-speed memory. The size and composition of a 
system’s memory is totally dependent on the application the system serves. 


Linkage and relocation is designed to handle the linking and locating of your pro- 
gram, no matter how your 8086-based system memory is implemented. It provides 
very flexible segment placement within any given memory configuration. 


8086 Addressing Techniques 


The 8086 addresses memory with a 20-bit address that is constructed from a segment 
address and a 16-bit offset from that segment address. This means that with a single 
segment address, 64K bytes of memory is directly addressable by changing only the 
offset. 


A hardware segment address is a 20-bit address. But the segment address is con- 
strained such that the segment is placed on a boundary that is a multiple of 16 (10H). 
The segment address can be set to any hexadecimal address ending in 0: 

0H 


010H 
020H 


OFFFFOH 
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Introduction iAPX 86,88 Family Utilities: 


Because the low four bits of the 20-bit segment address are always zero, the segment 
address can be represented with only 16 bits. 


The segment address is kept in one of four 16-bit segment registers. Because there 
are four segment registers, the 8086 can, at any moment, access 256K (4 x 64K) bytes 
of memory. The full megabyte of memory is accessed by changing the values in the 
segment registers. Figure 1-4 shows the 8086 addressing concept. 


SEGMENT 
REGISTER OFFSET 
12340H 
+ 8003H 
EFFECTIVE 20-BIT ADDRESS 
MEMORY 
FFFFFH 
64K BYTES CAN BE 
ADDRESSED BY 
CHANGING THE 
OFFSET ONLY 
0H 
Figure 1-4. 8086 Addressing 639-4 


Segments 


Programs comprise pieces called segments, which are the fundamental units of 
linkage and relocation. The basic divisions have functional purposes related to the 
hardware configuration of memory. The portions of programs that are to be kept in 
ROM or PROM can be put in separate segments from the portions that will be kept 
in RAM. 


The 8086 Assembler allows the programmer to name the segments of the program 
being developed. The PL/M-86 compiler may generate predefined names for 
segments. 


A segment is a contiguous area of memory that is defined at translation time 
(assemble or compile). When defined, a segment does not necessarily have a fixed 
address or size. A fixed address is assigned to a segment during the locate function. 
The size can be changed by combining segments and by a control that specifies a 
specific size. Some translations may produce absolute object information, with 
absolute addresses and a specific segment size. 
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LINK86 combines all segments with the same complete (segment, class and overlay) 
name and combination type (memory, stack, etc.) from all input modules. The 
ordering of segments is done on the basis of these combined segments. The manner 
in which segments are combined depends on the alignment of the segments (which is 
described in the next topic) and a combining attribute associated with the segment. 


When we refer to combining segments, we are talking about how the segments will 
be loaded in memory, not how they will be stored in the output module. The 
segments in the LOC86 output module contain addresses that determine where they 
will be loaded in memory. The segments reside in the output module in the same 
order as they were in the input modules. Figure 1-5 shows the physical relationships 
between the input modules, output module, and loaded program. 


OUTPUT OUTPUT MODULE 
INPUT MODULE LOADED IN 
MODULES ON DISKETTE MEMORY 


SEG C 


SEG F 


Figure 1-5. Segment Physical Relationships 639-5 


Segment Alignment 


A segment can have one (and in the case of the inpage attribute, two) of five align- 
ment attributes: 


e Byte, which means a segment can be located at any address 


e Word, which means a segment can be located only at an address that is a 
multiple of two, starting from address 0H 


Paragraph, which means a segment can be located only at an address that is a 
multiple of 16, starting from address 0 


Page, which means a segment can be located only at an address that is a multiple 
of 256, starting from address 0 


Inpage, which means a segment can be located at whichever of the preceding 
attributes apply, plus must be located so that it does not cross a page boundary 


Figure 1-6 shows the segment alignment boundaries. 
Any alignment attribute except byte can result in a gap between combined segments. 


For example, when two page-aligned segments are combined, there will always be a 
gap, unless the first happens to be an exact multiple of 256 bytes in length. 
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WORD = 2 BYTES 


PARAGRAPH = 16 BYTES 


PAGE = 256 BYTES 
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Figure 1-6. Segment Alignment Boundaries 639-6 


Segment Combining 


Segments containing data and code are combined end to end. There may be a gap 
between the segments if the alignment characteristics require it. The relative 
addresses in the segments are adjusted for the new longer segment. 


There are two special cases of segment combination: stack segments and memory 
segments. Such translators as PL/M-86 define these segments with the names 
STACK and MEMORY. With ASM86 you must define them by adding the STACK 
or MEMORY parameter to the SEGMENT directive. 


When stack segments are combined, they are overlaid but their lengths are added 
together. 


When memory segments are combined, they are overlaid with their low addresses at 
a common address. The length of the combined memory segment is the length of the 
largest segment that was combined. No relative address adjusting is necessary. Nor- 
mally the memory segment is located above (at a higher memory address) the rest of 
the program segments if no controls are used to override this. 


To make sure that stack segments are combined correctly, you should always give 
them the same segment name in each module. The same is true of memory segments. 
If you are going to link assembly language routines to PL/M-86 routines you should 
give them the names STACK and MEMORY to be compatible with PL/M-86. 


Segment Locating 


Segments are located in the order in which they are encountered in the input 
modules. If classes (described in the next section) are defined, the segments from a 
class are located together. The locating algorithm can be changed by using LOC86 
locating controls. 
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One variation to the sequential locating of segments is how the MEMORY segment 
is located. When the first segment with the memory attribute is encountered, it is 
placed last in the list of segments. This means that after all other segments are 
located, the MEMORY segment will be assigned the highest address in the output 
module. 


NOTE 


The MEMORY segment may not get located at the top of the module if its 
name or class name appears in any LOC86 control (other than SEGSIZE) or 
it has the absolute attribute. 


Classes 


A class is a collection of segments. When segments are defined in assembly 
language, a class name can be specified. The segments generated by such translators 
as PL/M-86 are generated with predefined class names. Any number of segments 
can be given the same class name. Class names can extend beyond module bound- 
aries; the same class name can be used in different modules that are to be combined. 


The primary purpose of classes is to collect together (in an arbitrary order) segments 
that share a common attribute and to manipulate this collection at locate-time by 
specifying only the class name. 


All segments with the same class name are located together in the memory address 
space of the output module. (You can override class collection by specifying the 
location of segments with the LOC86 ORDER control or LOC86 ADDRESSES 
control.) 


Classes give you a second means of collecting like segments in the output module. 
The first is giving segments the same name. If you are developing several modules 
that are to be combined, you may want to give the segment containing executable 
code the name CODE in each module. If there are several differently named 
segments within a module that contain executable code, you may want to give these 
segments the class name of CODE that causes them to be located together but not 
combined. (The same name can be used for segments and classes.) 


Groups 


A group is also a collection of segments. Groups define addressing range limitations 
in 8086 object modules. A group specifies a collection of segments that must be 
located within a 64K byte range. This means that the entire group of segments can be 
addressed with offsets from a single segment register. Or, to put it another way, the 
segment register need not be changed when addressing any segment in a group. This 
permits efficient addressing within the module. 


Group addressing always begins at an address that is a multiple of 16 (i.e., a 
paragraph boundary). R&L does not manipulate segments of a group to make sure 
they fall within a 64K byte range. However, if they do not fit in the range, a warning 
message is issued. 


The segments included in a group do not have to be contiguous in the output 
module. The only requirement is that all the segments defined in the group must 
totally fall within 64K bytes of the beginning address of the group. 
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Overlays 


Sometimes your 8086 program is too large to fit into the memory available on the 
system. Overlays permit programs to be larger than the available memory. 


Typically, an overlay is composed of code and data that is executed in one phase of a 
program’s execution, but not used at any other time. Once executed the memory 
used by this code can be overwritten with code and data used in an other phase. 
Sections of code that occupy the same part of memory at different times during 
execution are called overlays. 


Part of an overlaid program is always resident in memory; it usually comprises the 
main program module, frequently used routines, and the overlay loader. This part 
of the program is called the root. Figure 1-7 illustrates the memory configuration of 
one program that uses overlays. 
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Figure 1-7. Memory Configuration of Program with Overlays 639-7 


Position-Independent Code and Load-Time- 
Locatable Code 


An LTL (load-time-locatable) program can be loaded anywhere in memory (assum- 
ing alignment attributes are honored). Code and data addresses are assigned by the 
system loader. References to segment bases (segment registers) are permitted. The 
loader, when it determines where to locate each segment, must resolve these 
references to the segment bases. Before executing the LTL program, the loader must 
also initialize the segment registers. 


A PIC (position-independent-code) program is an LTL program, but it contains no 
references to segment bases. To execute these programs the loader need only place 
the program in memory (recognizing alignment attributes) and initialize the segment 
registers and go. No fixup of segment bases is required. 


LINK86 combines 8086 object modules and resolves references between 
independently translated modules. LINK86 takes a list of files and controls as input 
and produces two output files: a print file and an object file. 


Figure 2-1 illustrates the linkage process. The input files may be any object module 
(output from a translator, LINK86, LOC86 or an 8086 library file). The print file 
contains diagnostic information. The output object file is a bound load-time- 
locatable module or simply a relocatable module. 


This chapter provides details concerning the LINK86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LINK86 controls and information on error and warning messages that may be 
produced, refer to Appendix D. For details concerning symbol table space limita- 
tions, refer to Appendix C. 
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LINK86 Invocation Line 


The general syntax for the invocation line is: 


[directory-name|LINK86 input list[T 0 output file|[contro/s] 


The input list is one or more modules to be linked together into a single object - 


module: 
pathname| (module name|{,...|) ][,...] 


Unless a module name is specified, all modules in a pathname are included. If the 
pathname is a library file, any modules named in parentheses are included in the out- 
put file even if they do not contain public symbol definitions for external symbols 
declared elsewhere in the input list. 
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The input list may also contain the control PUBLICSONLY before selected 
pathnames. If you wish to include a file called PO or PUBLICSONLY, ensure that 
the filename is preceded by a directory-name in order to distinguish it from the con- 
trol or its abbreviation. 


The order of modules in the input list affects the order of segments in the output file. 


TO output file designates the file to receive the linked object module. If output file is 
not specified, then output is directed to a file that has the same pathname as the first 
element in the input list, but its extension is .LNK. If the first element in the list is a 
PUBLICSONLY control, then the first pathname in its argument is used for the 
default name. 


If the BIND control is specified, then the default name for the output file has no 
extension, and the object module can be executed without locating. 


The contro/s can be any subset of the controls specified in the next section. 


LINK86 Controls 


The controls are described in table 2-1. 
Table 2-1. Summary of LINK86 i 


ASSIGN({variable(address) }{,...]) Not applicable 
ASSUMEROOT (pathname) Not applicable 


NOBIND 


COMMENTS COMMENTS 
NOCOMMENTS 
FASTLOAD NOFASTLOAD 


Ce 
[rome 


OBJECTCONTROLS( Not applicable 
{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(symbol {,...])] | 
NOPUBLICS [EXCEPT(symbol [,...])I | 
TYPE |NOTYPE | 
PURGE | NOPURGE}(....]) 


fo} 
oO 


ORDER({group({segment|\class{\overlay}|} Not applicable ° 
[,--.])} 
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Table 2-1. Summary of LINK86 Controls (Cont’d.) 


o 


PRINTCONTROLS( 
{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS[EXCEPT(symbol|,...})] | 
NOPUBLICS [EXCEPT(symbo! [,...])] | 
TYPE | NOTYPE | 

PURGE | NOPURGE}(....]) 


J 
PUBLICS [EXCEPT(symbo! {,...])] PL [EC] PUBLICS 
NOPUBLICS [EXCEPT(symbo/{,...})] NOPL[EC] 


RENAMEGROUPS({group TO group } [,...]) RG 


SYMBOLS SYMBOLS 
NOSYMBOLS 
SYMBOLCOLUMNS({1 | 2] 3] 43) SC SYMBOLCOLUMNS(2) 
TYPE TY TYPE 
NOTYPE 

If you specify a control more than once in a single invocation line, only the last ver- 


sion entered counts. For example, if you enter NOMAP on the invocation line and 
then later decide you want a link map, you can specify MAP. The ASSIGN control, 
however, is an exception to this general rule. 


NOOVERLAY 


PRINT(object file.MP1) 


vU 
QO 


Not applicable 


SEGSIZE({segment{\class{\overlay]] 
( min-size|,[max-size]])}[,...]) 


NOTY 


The following controls are effective only when the BIND control is specified: 


FASTLOAD 
MEMPOOL 

ORDER 
PRINTCONTROLS 
SEGSIZE 
SYMBOLCOLUMNS 


The following control is effective only when the BIND control is NOT specified: 
INITCODE 


The following control is effective only when the OVERLAY control is specified: 
ASSUMEROOT 

At the end of this document you will find operating system-specific examples of the 

LINK86 controls. Fold out the pages containing the examples relevant to your 


operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Syntax 


ASSIGN ( {variable-name (address) }[,...]) 


Abbreviation 


AS 


Default 
Not applicable 


Definition 


ASSIGN makes it possible to define absolute addresses for symbols at LINK time. 
The absolute address associated with the variable-name is specified in address, 
which should be an absolute 20-bit memory address that conforms to PL/M-86 
notation. The variable-name is internally defined as a PUBLIC symbol. 


Notes 


e This control is particularly useful for memory-mapped I/O. 


e If the variable-name has a matching public definition in another module, the 
public definition in that module is flagged as as duplicate. Whenever a reference 
to the variable-name occurs, the variable defined in the ASSIGN control 
governs. 


e If multiple ASSIGN specifications are provided in one LINK86 invocation, all 
will be effective (not only the final entry). 
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Syntax 
ASSUMEROOT (pathname) 


Abbreviation 


AR 


Default 
Not applicable 


Definition 

ASSUMEROOT suppresses the inclusion of any library module(s) in an overlay if 
the library module(s) have already been included in a root file identified by 
pathname. When this control is used, the root file is scanned, and all external, 
undefined symbols in the overlay modules which have a matching definition in the 
root file are marked ‘‘temporarily resolved.”’ This marking means that while a 
library search for the symbols will not be made, their status remains externally 
undefined until the overlays are linked with the root. 


Notes 

e This control should be used only in conjunction with the OVERLAY control 
and libraries. 

e This control will not eliminate common library modules from overlay to 
overlay. 

e This control may not be used when an input module already has an overlay 
record. 
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Syntax 


BIND 
NOBIND 


Abbreviation 


BI 
NOBI 


Default 


NOBIND 


Definition 


BIND combines the input modules into a load-time-locatable (LTL) module. An 
LTL module may be loaded and executed, and any logical reference to a segment or 
group base can be resolved at load time. The load-time-locatable output cannot be 
loaded by the ICE-86 loader or UPM. 


Notes 


¢ FASTLOAD, MEMPOOL, ORDER, SEGSIZE, and SYMBOLCOLUMNS 
have no effect when NOBIND is specified. 


° When NOBIND is in effect, [NO]LINES, [NO]SYMBOLS, [NO]PUBLICS, 
and [NO|]PURGE affect only the output object module. 


e When BIND is specified, the default object file name has no extension. 
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Syntax 


COMMENTS 
NOCOMMENTS 


Abbreviation 


CM 
NOCM 


Default 
COMMENTS 


Definition 


COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as nonpurgable. 


Comment records are added to the object module for various reasons. All 
translators add a comment record, identifying the compiler or assembler that pro- 
duced it. 


Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process. 


Notes 


e See PURGE, PRINTCONTROLS and OBJECTCONTROLS. 


¢ COMMENT records should not be removed when you submit an object file ina 
Software Problem Report. 


¢ NOCOMMENTS will decrease the size of the output object file. 
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Syntax 


FASTLOAD 
NOFASTLOAD 


Abbreviation 


FL 
NOFL 


Default 
NOFASTLOAD 


Definition 


FASTLOAD reduces program loading time by causing data record concatenation. 
The data records are concatenated to a maximum length of 64K. FASTLOAD also 
makes the object file compact by removing such information as local symbols, 
public records, comments, and type information (unless the object file contains 
unresolved external symbols). 


Notes 
e This control is effective only when BIND is specified. 


¢ Output produced with this control in effect may be incompatible with LINK86 
versions earlier than 2.0. 
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Syntax 
INITCODE 


Abbreviation 


Ic 


Default 
Not applicable 


Definition 


INITCODE 


INITCODE causes LINK86 to create a new segment that contains code to initialize 
the segment registers. The equivalent assembly language code is shown below: 


STACKFRAME 
DATAFRAME 
EXTRAFRAME 


Notes 


DW 
DW 
DW 
CLI 
MOV 
MOV 
MOV 
MOV 
JMP 


stack frame 
data frame 
extra frame 


SS, CS:STACKFRAME 
SP, stack offset 

DS, CS:DATAFRAME 
ES, CS:EXTRAFRAME 
program start 


e ©The initialization code segment is created only if a register intialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 


modules. 


e BIND and OVERLAY controls used in conjunction with INITCODE will cause 
LINK86 to ignore the INITCODE control and issue a warning message. 


e INITCODE should be used to ensure compatibility with 8085-based LINK86, 
LOC86, and LIB86 products. 


e The name of the new segment, if created, is ??INITCODE. 
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Syntax 


LINES 
NOLINES 


Abbreviation 


LI 


NOLI 


Default 


LINES 


Definition 


LINES allows line number information to remain in the object file. ICE-86 and 
other debuggers use this information. The line number information is not needed to 
produce executable code. The NOLINES control removes this information from the 
output file. 


Notes 


See PRINTCONTROLS and OBJECTCONTROLS. 

See the PURGE control. 

NOLINES will decrease the size of the output object file. 

Unless BIND is in effect, LINES/NOLINES affects only the object module. 


LINES has no effect on local symbols; the inclusion of local symbol records in 
the object file is controlled by SYMBOLS. 
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Syntax 


MAP 
NOMAP 


Abbreviation 


MA 
NOMA 


Default 
MAP 


Definition 


MAP produces a link map and inserts it in the PRINT file. The link map contains 
information about the attributes of logical segments in the output module. This 
includes size, class, alignment attribute, address (if the segment is absolute) and 
overlay name (if the segment is a member of an overlay). 


NOMAP inhibits the production of the link map. 


Notes 


e MAP can be overridden by the NOPRINT control. 
e See the discussion of the link map at the end of this chapter. 
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Syntax 


MEMPOOL (minimum-size[ ,maximum-size]) 


Abbreviation 


MP 


Default 
Not applicable. 


Definition 


MEMPOOL specifies the dynamic memory requirements of the program. This 
allows the loader to check free memory at load time, and prevent a run-time error. 


The minimum size is a 20-bit number. There are three ways of specifying this value: 


e + indicates that the number should be added to the current dynamic memory 
requirements. 


e — indicates that the number should be subtracted from the current dynamic 
memory requirements. 


¢ no sign indicates that the number should become the new minimum dynamic 
memory requirement. 


The maximum size is a 20-bit number. There are two ways of specifying this value: 


e + indicates that the number should be added to the current minimum dynamic 
memory requirement. 


* no sign indicates that the number should become the new maximum dynamic 
memory requirement. 


Notes 


e The minimum-size must be less than or equal to the maximum-size. 
e MEMPOOL has no effect unless the BIND control is also specified. 
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Syntax 


NAME (module name) 


Abbreviation 


NA 


Default 


The module name of the first element in the input list. 


Definition 


NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module will have the name of the first module in the input 
list. 


The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 


? (question mark), 
@ (commercial at), 
: (colon), 

. (period), 

__ (underscore), 

A, B, C, ..., Zor 
0: 4,234005 9: 


Lower-case letters may be used, but they are automatically converted to uppercase. 


Notes 


¢ NAME does not affect the output file’s name. Only the module name in the 
output module’s header record is changed. 


NAME 
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Syntax 


OBJECTCONTROLS({LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS 
PUBLICS [EXCEPT (symbol[,...])] | 
NOPUBLICS [EXCEPT (symbol[,...])]] 
TYPE | NOTYPE | 
PURGE | NOPURGE}[,...] 
) 


Abbreviation 


0c 


Default 
Controls apply to both the print file and the object file. 


Definition 


OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file nor the information contained in it. 


Notes 


e Abbreviations for the controls within the parentheses may be given. 


e Acontrol specified in both OBJECTCONTROLS and PRINTCONTROLS has 
the same effect as specifying it once outside of these controls. 
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Syntax 


ORDER ( {group name ( {segment name 
[ \class name|\overlay name]]|} 


ee Pe 
Lace 
Abbreviation 
0D 
Default 


Segments are placed into object file in the same order in which they were 
encountered in the input list. 


Definition 
ORDER specifies a partial or complete order for the segments in one or more 
groups. 


The group name identifies the group whose segments are to be ordered. 


The segment name identifies the segments to be ordered. The \class name and 
\overlay name may be used to resolve conflicts with duplicate segment names. If 
\overlay name is specified, the \class name is required. 


Notes 


¢ ORDER has no effect unless BIND is also specified. 


e If one of the segments specified is not contained in the designated group, an 
error message is generated. 


e See discussion of module combination at the end of the chapter for details of the 
default ordering. 
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Syntax 


OVERLAY| (overlay name) | 
NOOVERLAY 


Abbreviation 


OV 
NOOV 


Default 
NOOVERLAY 


Definition 

OVERLAY specifies that all of the input modules shall be combined into a single 
overlay module. When the optional overlay name argument is specified, all 
segments contained within the overlay module have that name in addition to their 
segment names and class names. When overlay name is not specified, LINK86 uses 
the module name of the first module in the input list. 


Notes 

e Each overlay in a given program must be linked separately before they are all 
linked into a single object module. 

e The overlay specified in the argument must be the same as the overlay name 
used when calling the operating system to load the overlay. 

e When linking root and overlay files, LINK86 assumes the first file in the 
invocation line is the root. 


¢ The ASSUMEROOT control can be specified in conjunction with the 
OVERLAY control. 
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Syntax 


PRINT| (pathname) | 
NOPRINT 


Abbreviation 


PR 
NOPR 


Default 


PRINT (object file. MP1) 


Definition 


PRINT allows you to direct the link map and other diagnostic information to a 
particular file. If the PRINT control is not specified or if the control is given without 
an argument, the print file will have the same pathname as the output file except the 
extension will be .MP1. NOPRINT prevents the creation of this file. 


Notes 


e The discussion at the end of this chapter describes the contents of the print file. 


e MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS and 
PRINTCONTROLS affect the contents of the print file. 
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Syntax 


PRINTCONTROLS({LINES | NOLINES 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(symbol{,...])] | 
NOPUBLICS [EXCEPT (symbol[,...])]| 
TYPE | NOTYPE | 
PURGE | NOPURGE?}[,...] 
) 


Abbreviation 


PC 


Default 
Controls apply to both the print file and the object file. 


Definition 
PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 


tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 


Notes 


e When a control is specified in both the PRINTCONTROLS and the 
OBJECTCONTROLS, it has the same effect as specifying it once outside of 
these controls. 


e Abbreviations to the parenthesized controls may be used. 


¢ Unless BIND is specified, PRINTCONTROLS and its arguments have no 
effect. 
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Syntax 


PUBLICS [EXCEPT (public symbo!|,...])} 
NOPUBLICS[EXCEPT (public symbol! [, ...]) | 


Abbreviation 


PL [EC] 
NOPL [EC] 


Default 
PUBLICS 


Definition 


PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. Public symbol records are 
needed to resolve external symbol definitions in other files. The EXCEPT sub- 
control allows you to modify the control. Public records are used by LINK86 to 
resolve external references. 


Notes 
e The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 


e Unless BIND is specified PUBLICS/NOPUBLICS affect only the object file. 
e NOPUBLICS will decrease the size of the output object file. 
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Syntax 


PUBLICSONLY (pathname [,...]) 


Abbreviation 


PQ 


Default 
Not applicable 


Definition 
PUBLICSONLY is an input list control. When used it must appear in the input list 
and not the control list. 


PUBLICSONLY indicates that only the absolute public symbol records of the argu- 
ment files will be used. The other records in the module will be ignored. This can be 
used to resolve external references to 8089 files and overlays when a multifile overlay 
system is desired. 


Notes 


e Although it is possible to create overlays using PUBLICSONLY, it is easier to 
use the OVERLAY control to create overlays. 
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Syntax 


PURGE 
NOPURGE 


Abbreviation 


PU 
NOPU 


Default 


NOPURGE 


Definition 


PURGE in the control list is exactly the same as specifying NOLINES, 
NOSYMBOLS, NOCOMMENTS, NOPUBLICS, and NOTYPE. NOPURGE in 
the control list is the same as specifying LINES, SYMBOLS, COMMENTS, 
PUBLICS, and TYPE. 


PURGE removes all of the debug or public records from the object file and their 
information from the print file. It will produce the most compact object file 
possible. 


The records that would be included by NOPURGE are useful to debuggers, but 
otherwise they are unnecessary for producing executable code. 


Notes 
e PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 


e Unless BIND is specified, PURGE affects only the output object file. 
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Syntax 
RENAMEGROUPS ({group name TO groupname} [,...]) 


Abbreviation 


RG 


Default 
All groups keep the name they already have. 


Definition 


RENAMEGROUPS allows you to change the group names assigned by the 
translator. The first group name must be an existing group in one of the modules in 
the input list. 


Notes 


None 


2-22 


iAPX 86,88 Family Utilities SEGSIZE 


Syntax 


SEGSIZE( {segment name|\class name{\overlay name]| 
(minimum size| , [maximum size]]) } 
ee P 


Abbreviation 


$$ 


Default 
Not applicable 


Definition 


SEGSIZE allows you to specify the minimum memory space needed for any seg- 
ment. If you specify the maximum size for a segment, that segment must either not 
be a member of any group or be the last segment in the group. 


The segment name identifies the segment whose size is to be changed. 


The minimum size is a 16-bit number. There are three ways of specifying this value: 
e + indicates that the number should be added to the current segment length. 


e — indicates that the number should be subtracted from the current segment 
length. 


¢ no sign indicates that the number should become the new segment length. 


The maximum size is a 16-bit number. There are two ways of specifying this value: 
e + indicates that the number should be added to the minimum segment length. 


¢ no sign indicates that the number should become the new maximum segment 
length. 


Notes 


e The maximum segment size must always be greater than or equal to the 
minimum segment size. 


e Segment lengths are initially assigned by the translator. 
e Unless BIND is also specified SEGSIZE has no effect. 
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Syntax 


SYMBOLS 
NOSYMBOLS 


Abbreviation 


$B 
NOSB 


Default 
SYMBOLS 


Definition 
SYMBOLS specifies that all local symbol records shall be included in the object file. 
Local symbol records are used by debuggers. 


Notes 
e Unless BIND is also specified, SYMBOLS affects only the output object file. 
¢ NOSYMBOLS will decrease the size of the output object file. 


e SYMBOLS has no effect on line numbers; the inclusion of line numbers in the 
object file is controlled by the LINES control. 
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Syntax 
SYMBOLCOLUMNS({1 | 2 | 3 | 4}) 


Abbreviation 


SC 


Default 
SYMBOLCOLUMNS (2) 


Definition 


SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 


Notes 
¢ SYMBOLCOLUMNS has no effect unless BIND is also specified. 
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Syntax 


TYPE 
NOTYPE 


Abbreviation 


TY 
NOTY 


Default 
TYPE 


Definition 
TYPE specifies that type checking is to be performed on the object file. Symbol type 
records produced by the translator are used by LINK86 to perform type checking on 
modules. Symbol type records should be kept in the file if it may be relinked with 
another file. 


Notes 


e NOTYPE will decrease the size of the ouput object file without affecting 
run-time operation. 
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LINK86’s Print File 


The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MP1. 


The print file may contain as many as five parts: 
1. A header (always in the print file) 


2. A link map (requires MAP) 

3. A group map (requires BIND) 

4. Asymbol table (requires BIND and PUBLICS, LINES, or SYMBOLS) 
5. An error message list (always included when they occur) 

The Header 


The header is self-explanatory; it identifies the 8086 linker by version number and 
gives the important details about the input and output files used during this execu- 
tion. Figure 2-2 shows an example of LINK86’s print file header. 


system-id 6086 LINKER, Vxy 


INPUT FILES: : pathname,pathname2 

OUTPUT FILE: : pathname? 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
ND 


DATE: MM/DD/YY TIME: HH:MM:SS 


Figure 2-2. LINK86 Print File Header 


The Link Map 


The link map supplies useful information about segments in the object file — order, 
size, alignment attribute, and segment, class, and overlay names. Figure 2-3 shows 
LINK86’s link map. 


LINK MAP OF MODULE ROOT 


LOGICAL SEGMENTS INCLUDED: 
LENGTH OVERLAY 


MEMOKY 


INPUT MODULES INCLUDED: 
pathname1l(ROOT) 


Figure 2-3. LINK86 Link Map 


LINK86 


2-27 


LINK86 


2-28 


iAPX 86,88 Family Utilities 


The map consists of three parts: 
e Segment map 

e Input module list 

e Unresolved symbol list 


The segment map describes all of the segments included in the object file. Each seg- 
ment description includes five entries: length, the address (if the segment is 
absolute), alignment attribute, segment name, class name and overlay name, if any. 


A segment may have any one of the following alignment attributes: 


absolute 

byte 

paragraph 

member of an LTL group 
page 

word 

in-page 


AS VEOoo> 


In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first 2- 
hexadecimal digits (OOH, 100H, 200H,...0FFFOOH). 


The module list identifies the order of modules included in the output file. LINK86 
gives both the file containing the module and the module name for each entry in the 
list. 


The unresolved symbol list itemizes each external symbol whose public definition 
was not encountered. The module that references the unresolved symbol is also 
indicated. The printed message that appears under the heading UNRESOLVED 
EXTERNAL NAMES is as follows: 


e symbolname IN pathname (module name) 
e If ASSUMEROOT is specified, the message would read: 
symbolname (DEFINED IN ROOT-FILE,pathname) 
e If PUBLICS/NOPUBLICS EXCEPT is specified, the message would read: 


symbol name IN LINK86 COMMAND LINE 


The Group Map 


LINK86 produces a group map when the BIND control is specified. Each group 
name and all segments contained in that group are listed. The offset from the group 
base for each segment appears to the right of the segment name. Figure 2-4 shows an 
example of the group map. 


GROUP MAP 


GROUP NAME: CGROUP 
OFFSET SEGMENT NAME 
0000H CODE 


GROUP NAME: DGROUP 
OFFSET SEGMENT NAME 
QO00H CONST 
0016H DATA 
OB4EH STACK 
OF9OH MEMORY 


Figure 2-4. LINK86 Group Map 
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The Symbol Table 


LINK86 produces a symbol table only when the following conditions are true: 


1. BIND is specified 
2. PRINT and MAP controls are in effect. 


3. At least one of the following controls is in effect: PUBLICS, LINES, or 
SYMBOLS. 


Figure 2-5 shows LINK86’s symbol table with the SYMBOLCOLUMNS set at two 
(the default). The symbol table is shown in two parts: the top section contains the 
public symbol information; the lower section contains line and local symbol 


information. 


SYMBOL TABLE OF MODULE ROOT 
BASE OFFSET TYPE SYMBOL OFFSET TYPE SYMBOL 


G(2) 0166H PUB BINDCONTROL OO4CH PUB BNODEBASE 

Gi2) 0018H PUB BUFBASE 0016H PUB BUFLEN 

G(2) OO4EH PUB CLASHNODEBASE 0060H PUB COCONN 

G(2) O15AH PUB COMMENTSCONTROL 0171H CURRENTOVERLAYNU 

: -M 

G(2) 0173H PUB DEBUGTOGGLE OOATH DEFAULTPRTFILENA 
-ME 

G(2) 0062H PUB EXCEPTION 0048H FANODEBASE 

G(2) OO06EH PUB FBLOCKBASE 006AH FBLOCKLISTHEAD 

G(2) OO6CH PUB FBLOCKLISTTAIL 013DH FBLOCKSEQUENCENU 
-MBER 

6(2) OO%AH FBNODEBASE 0046H FDNODEBASE 

G(2) 00448 FENODEBASE O0O040H FFNODEBASE 

G(2) 00348 FIRSTBNODEP 0028H FIRSTEXNODEP 

&(2) 002CH FIRSTGRNODEP 001CH FIRSTNMNODEP 

G(2) 00308 FIRSTOVNODEP 0050H FIRSTRENAMEBLOCK 
-P 

G(2) 0020H FIRSTSGNODEP 0024H FIRSTTDNODEP 

G(2) 0038H GRNODEBASE OB4CH HIGHESTDATALOCAT 
-ION 


MODULE NAME = ROOT 
BASE OFFSET TYPE SYMBOL OFFSET TYPE SYMBOL 


G(2) OF9OH SYM MEMORY 0000H SYM COPYRIGHT 
-6(2) 0016h SYM BUFLEN 0018H SYM BUFBASE 
G(1) OOF7H SYM ERROR OOFEH SYM WARNING 
G(2) 0O1Ah SYM LASTNMNODEP OO1CH SYM FIRSTNMNODEP 
G(2) QO1EH SYM LASTSGNODEP 0020H SYM FIRSTSGNODEP 
G(2) 0022H SYM LASTTDNODEP O024H SYM FIRSTTONODEP 
G(2) 0026H SYM LASTEXNODEP 0026H SYM FIRSTEXNODEP 
G(2) O02AH S¥M LASTGRNODEP 002CH SYM FIRSTGRNODEP 
G(2) OO2EnH SYM LASTOVNODEP 0030H SYM FIRSTOVNODEP 
G(2) 0032H SYM LASTBNODEP 0034H SYM FIRSTBNODEP 
G(2) 0036 SYM SGNODEBASE 0038H SYM GRNODEBASE 
G(2) OO3AH SYM SYNODEBASE 003CH SYM NMNODEBASE 
G(2) OO3EKH SYM TDNODEBASE OO40H SYM FFNODEBASE 
G(2) 0O42H SYM OVNODEBASE OO44H SYM FENODEBASE 
G(2) OO46H SYM FDNODEBASE OO48H SYM FANODEBASE 
G(2) OO8AH SYM FBNODEBASE OO4CH SYM BNODEBASE 
G(2) OO4EH SYM CLASHNODEBASE 0050H SYM FIRSTRENAMEBLOCK 
-P 


Figure 2-5. LINK86 Symbol Table 


LINK86 
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SYM S1GNONMSG SYM PRINTNAME 
SYM INITIALIZEINPUT SYM OPENFBLOCKFILE 
SYM CLOSEFBLOCKFILE LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 

LIN LIN 


REFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 


Figure 2-5. LINK86 Symbol Table (Cont’d.) 


BASE is usually a symbolic group or segment index. If the base is the stack, then 
STACK is used instead of the index. 


OFFSET is a four-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 


TYPE describes the kind of symbol it is. There are four possible entries in the TYPE 
column: 


BAS based on an other symbol’s value 

LIN line (not a symbol) 

PUB public symbol (alphabetized within each separate BASE) 
SYM local symbol 


SYMBOL refers to the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is one, this field is 40 characters wide. Otherwise, this 
field is 16 characters wide. If the symbol name is longer than the width of the field, 
then the name is hyphenated and continued on the next line. 


If there are any references to segment bases in the input modules (if the output 
module is an LTL program), LINK86 prints the following message at the bottom of 
figure 2-5. The message identifies all input modules containing such references. 
These references are to be resolved by the system loader or LOC86. 

Error Messages 

The warning messages are listed consecutively as warning situations are 
encountered. They may appear before or after the link map. Errors always terminate 
processing—an error message will always be the last line in the print file. 


See the discussion of the interpretation of individual messages in Appendix C. 
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CHAPTER 3 


CREF86 


CREF86 scans 8086 object modules to provide a cross-reference among external and 
public symbols in multiple modules. CREF86 accepts a list of files and controls as 
input and produces one output file: a print file. 


Figure 3-1 illustrates the types of input accepted and output produced. The input 
modules may include one or more of the following 8086 object modules: 


¢ Unlinked modules from one or more translators 
e = Library files or specific library modules 
e Linked modules 


The output file consists of information about files and modules, plus an 
alphabetically sorted list of external and public symbols. Information printed for 
each symbol includes the name of the module defining the symbol and the name(s) 
of the module(s) declaring the symbol as external. 


This chapter provides details concerning the CREF86 invocation, controls, and 
cross-reference listing. For definition of file-naming and syntax notation conven- 
tions used in this chapter, refer to Notational Conventions following the Preface. 
For a summary of the CREF86 controls and information on error and warning 
messages which may be produced, refer to Appendix E. For details concerning 
CREF86 symbol table space limitations, refer to Appendix C. 


| 


TRANSLATED 
BJECT 
MODULE(S) [| 


LIBRARY 
MODULE(S) 


LINKED 


INVOCATION 
LINE CONTROLS 


r Ee aeane eee a 
PRINT FILE 
eee d 


CONSOLE 
OBJECT MESSAGES 
MODULE(S) | 
Figure 3-1. CREF86 Input and Output Files 121616-5 
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CREF86 Invocation Line 


The general syntax for invocation is: 
[|directory-name|CREF86 input list|controls]| 


The input list is one or more modules to be scanned for external-public cross- 
references: 


pathname| (module name[,...]) ][,--.] 


Unless a module name is specified, all modules in a pathname are included in the 
cross-reference listing produced. If the pathname is a library file, any modules 
named in parentheses are included in the cross-reference listing, even if they do not 
contain public symbol definitions for external symbols declared elsewhere in the 
input list. 


Either all or none of the pathnames may contain overlay records (produced by 
LINK86 with the OVERLAY control). If the input modules do contain overlay 
records, the first file named in the invocation is considered to be the root file; the 
rest are treated as overlays. 


The controls can be any subset of the controls described in the next section. 


CREF86 Controls 


The controls specify cross-reference listing attributes such as print file name, the 
title at the top of each listing page, and the amount of information printed on each 
page. The controls are described in table 3-1. 


Table 3-1. Summary of CREF86 Controls 


Cont eee ee ee 
PAGELENGTH(number) PAGELENGTH(60) 
PAGEWIDTH(120) 


ee 
[—rawrieamnenes |e | Pawtvatinut incre 


TITLE(character-string) Not applicable 


If there are multiple occurrences of any control in the invocation line, the rightmost 
occurrence governs. 


At the end of this document you will find operating system-specific examples of the 
CREF86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Syntax 


PAGELENGTH (number) 


Abbreviation 


PL 


Default 

PAGELENGTH(60) 

Definition 

PAGELENGTH specifies the number of lines to be printed on each page. The 


number must be a decimal value between 10 and 255, inclusive. 


Notes 


None 
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Syntax 
PAGEWIDTH (number) 


Abbreviation 


PW 


Default 
PAGEWIDTH(120) 


Definition 


PAGEWIDTH specifies the maximum number of characters to be printed on a 
single line. The number must be a decimal value from 80 to 132, inclusive. 


Notes 
e PAGEWIDTH truncates the TITLE if TITLE is greater than the number of 
unused character locations on the title line. 


e If the specified PAGEWIDTH does not allow enough space to print the 
referring module name(s) on the same line as the defining module name, the 
referring module names(s) will be printed on separate lines. 
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Syntax 
PRINT| (pathname) | 


Abbreviation 


PR 


Default 
PRINT (first input file. CRF) 


Definition 


PRINT provides the ability to specify a pathname for the cross-reference listing. 
The pathname identifies the destination of the listing. If the PRINT control is not 
specified or if the control is given without an argument, the print file will have the 
same pathname as the first file in the input list, except the extension will be .CRF. 


Notes 


e If no PRINT control is specified, output goes to a default file. The name of the 
default file is the name of the first file in the invocation command with the 
extension .CRF. 


e If PRINT is specified with no pathname, output goes to the default file. 


PRINT 
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Syntax 


TITLE (character string) 


Abbreviation 


TT 


Default 
Not applicable 


Definition 


TITLE may be used to specify a heading having a character string of null to 80 
characters, inclusive. This heading appears on the first line of every page of the 
cross-reference listing. 


Notes 
e The TITLE string is truncated if the PAGEWIDTH control is not large enough 
to accommodate the entire string. 


e If the character string contains any characters defined by the operating system 
as special, the string must be delimited in accord with operating system conven- 
tions for special characters and string delimiters. 
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CREF86’s Print File 


The print file is a cross-reference listing of external and public symbols in the input 
modules. This listing consists of the following parts: 


e A header 

e Warnings (if any) 

e Module list 

e Cross-reference information 


Header 


Figure 3-2 illustrates the components printed in this part of the cross-reference 

listing: 

e A title line output by CREF86, usually consisting of a program identifier 
(CREF86), any user-defined TITLE, date of listing, and the page number 


e A line identifying the CREF86 environment (operating system and version 
number) 


e One or more lines summarizing the pathnames of input files 
e A line for identifying the print file pathname 
e One or more lines giving the controls specified at invocation, present only if 


controls were specified 
Warnings 
Figure 3-3 illustrates how warning messages appear on the cross-reference listing 


when CREF86 detects such conditions as mismatched types, modules not found, etc. 
Refer to Appendix E for information on CREF86 error and warning messages. 


CREF66 EXAMPLE OF CROSS REFEHENCE USING CREF656 MM/DD/YY 


system-id CKEF60 Yx.y 


INPUT FILES: pathname4 pathname5 pathname6 
pathname10 pathnamet? pathname12 
pathname 16 pathnames7 

OUTPUT FILE: 

CONTROLS SPECIFIED: PR(OUT) TT( EXAMPLE OF CROSS REFERENCE USING CREf&6) PW(120) PL(60) 


Figure 3-2. Header of Cross-Reference Listing 


WARNING 19: TYPE MISMATCH 
FILE:  paifmamel5 
MODULE: MISMATCH 
SYMBOL: ENAMEID 

WARNING 19: TYPE MISMATCH 


FILE: pathnamel5 
MODULE: MISMATCH 
SYMBOL: FOUR 
WARNING 20: SPECIFIED MODULE NOT FOUND 
FILE: 
MODULE: UNKNOWN_MODULE 


Figure 3-3. Warning Messages on CREF86 Listing 
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Module List 


The module list, shown in figure 3-4, is a tabulated summary of all input files and 
corresponding modules included from these files. 


After the module list is printed, the rest of the page is skipped, so that the symbol 
cross-references begin on the next new page. 


MODULES INCLUDED: 
FILE NAME MODULE NAME(S) 


pathnamet CREF 86 

pathname2 PARSE 

pathname? SIGNON 

pathname4 NEXTSTATE 

pathname5 ERROR 

pathname6 UTILITIES 

pathname7 MEMORYMANAGEMENT 

pathname’ SCANMODULES 

pathname9 PROCESSRECORDS 

pathname10 SCANUTILITIES 

Pathnamet1 LISTOUTPUT 

pathnamet2 LISTUTILITIES 

pathnamet3 SYMBOLSORT 

pathnametl4 OBJMAN 

pathnamet§ MISMATCH 

pathnamet6 

pathname17 DQALLOCATE DQATTACH DQCHANGEEXTENSION DQCREATE DQDECODEEXCEPTION 
DQDETACH DQEXIT DQFREE DQGETARGUMENT DQGETSYSTEMID 


DQGETTIME DQOPEN DQREAD DQSEEK DQWRITE 
SYSTEMSTACK 


Figure 3-4. Module List on CREF86 Listing 


Symbol Cross-Reference Information 


Figure 3-5 illustrates the format for listing data for all external and public symbols 
referenced in the Module List. 


The first column contains the names of the external and public symbols, in 
alphabetical order. 


The second column identifies the type of each symbol, as declared in the external or 
public reference. The following tabulation identifies the entries which may occur in 


this column: 

CREF86 Entry Symbol Type 
BYTE 8-bit unsigned 
WORD 16-bit unsigned 
DWORD 32-bit unsigned 
LWORD 64-bit unsigned 
INTEGER (rn) n=1, 2,4, or8 bytes 
REAL (n) n=1, 2, 4, or 8 bytes 
POINTER 
STRUCTURE 
ARRAY OF 
UNKNOWN null 
FILE 
LABEL 
PROCEDURE 

(NEAR, FAR) 

CONSTANT 
SELECTOR 


The symbol type that appears in the second column is that associated with the first 
occurrence of that symbol in the input list. 
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CREF&6 EXAMPLE OF CROSS 


SYMBOL NAME 


ACCESS_P AGE 
ALLOCATS 
APPENDNODE. . 
APPENDO DSMNODE 
ARRAYBASE . 1... 
ATOI. 2 6 2 we ew ee 


BTOX. . 2. 2 2 we we 
BUBBLESORTVARNAMES. . 
BUMPLINECOUNT . .. 


CHECKHEADER 
CHECKOVERLAY 


CONTROLIDCOORDINATE . . 
CONTROLOFFSETCOORDINATE 
CONTROLSARESPECIFIED. . . 
CREATEOBJECT 


CURRENTOVLAUM 
CURRENT_P AGE 


DEBUGTOGGLE 

DEBUGTOGGLE 

DQALLOCATE 

DQATTACH 
DQCHANGEEXTENSION . ... 
DQCREATE 
DQDECODEBXCEPTION . ... 
DQDETACH 


DQGETARGUMENT 
DQGETSYSTEMID 
DQGETTIME 


REFERENCE USING 


SYMBOL TYPE 


UNKNOWN 
UNKNOWN 
PROCEDURE 
PROCEDURE 
POINTER 
PROCEDURE 


PROCEDURE 
PROCEDURE 
PROCEDURE 


PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
WORD 
WORD 
WORD 
BYTE 
BYTE 
PROCEDURE 


BYTE 
UNKNOWN 


BYTE 

BYTE 

PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 


MM/DD/YY 


DEFINING MODULE; REFERRING MODULE(S) 


OBJMAN 
OBJMAN 
UTILITIES 
UTILITIES; 
SYMBOLSORT; 
UTILITIES; 


UTILITIES; 
SYMBOLSORT; 
LISTUTILITIES; 


SCANUTILITIES; 
SCANUTILITIES; 
SCANUTILITIES; 
LISTUTILITIES; 
UTILITIES; 
UTILITIES; 
UTILITIES; 
PARSE; 

PARSE; 

PARSE; 

OBJMAN; 


PROCESSRECORDS; 
OBJMAN 


PARSE; 


PARSE SCANMODULES 
LISTOUTPUT 
PARSE 


PROCESSRECORDS 


LISTUTILITIES 
LISTOUTPUT 
LISTOUTPUT 


SCANMODULES 
SCANMODULES 
PROCESSRECORDS 
SYMBOLSORT 
NEXTSTATE 
MISMATCH 
SIGNON ERROR 
UTILITIES 
UTILITIES 
UTILITIES 
PARSE SCANMODULES PROCESSRECORDS 
SCANUTILITIES SYMBOLSORT 
SCANUTILITIES 


SCANMODULES SCANUTILITIES 


MISMATCH 


ROR 


®SBEDUPLICATE DECLARATION#®#*#*: MISMATCH 


DQALLOCATE; 
DQATTACH; 
DQCHANGEEXTENSION; 
DQCREATE; 
DQDECODEEXCEPTION; 
DQDETACH; 

DQEXIT; 

DQFREE; 
DQGETARGUMENT; 
DQGETSYSTEMID; 
DQGETTIME; 


MEMORY MANAGEMENT SYMBOLSORT OBJMAN 
UTILITIES SCANUTILITIES 
PARSE 

UTILITIES 

ERROR 

SCANMODULES 

CREF86 ERROR 

LISTOUTPUT 

PARSE 

SIGNON 

LISTOUTPUT 


Figure 3-5. Symbol Cross-Reference Information 


CREF86 


The third column contains the following for each symbols listed: 


¢ The name of the module in which the symbol is defined public (defining 


module) 


e A semicolon (;), if there are external references to the symbol in any of the input 


modules 


¢ The name(s) of the modules(s) in which the symbol is declared external 


(referring module(s)) 


The third column is also used to flag unresolved and duplicate references. In the case 
of unresolved external references, the string *** UNRESOLVED*** appears before 
the semicolon. In the case of duplicate references, i.e., when a symbol has two or 
more public definitions, the first public declaration is considered legal, and the rest 
are flagged as duplicates. The string ***DUPLICATE DECLARATION*** 
appears, followed by a colon (:) and the name of the module containing the 


duplicate public declaration. 


If the input files contain overlays, CREF86 produces a symbol cross-reference that 
consolidates all the symbols from all overlay and root modules. The first file in the 
input list is considered to be the root file. CREF86 distinguishes between public 
symbols with the same name in different overlays and does not flag these symbols as 
duplicates. However, CREF86 does flag duplicate public declarations within any 


one root/overlay combination. 
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CHAPTER 4 


LIB86 allows you to create, modify, and examine library files. It is an interactive 
program. 


This chapter provides details concerning LIB86 invocation and commands. For 
definition of file-naming and syntax notation conventions used in this chapter, refer 
to Notational Conventions following the Preface. For a summary of the LIB86 com- 
mands and information on error and warning messages that may be produced, refer 


to Appendix F. For details concerning LIB86 symbol table space limitations, refer to 
Appendix C. 


LIB86 Invocation 


The general syntax for the invocation line is: 


[directory-name|L1B86[comment] 


LIB86 Commands 


Once LIB86 has begun execution, it displays an asterisk (*) and waits for a com- 
mand. Table 4-1 lists all of LIB86’s commands. 


Table 4-1. Summary of LIB86 Commands 


| commana | ate. |Description 
ADD {pathname|(module name |,...])|} Adds modules to a library 


[,...] TO pathname 


CREATE pathname Creates library files 
DELETE pathname(module name {,...]) BS a, Deletes modules from a library file 
EXIT te Terminates session with LIB86 

L 


LIST {pathname|[(module name [,...])]} Lists modules contained in a library 
[,-..] [TO pathname] [PUBLICS] [P] file, and optionally lists all publics 


At the end of this document you will find operating system-specific examples of the 
LIB86 commands. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 


LIB86 
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Syntax 


ADD {pathnamet| (module name[,...])]}[,...]10 pathname2 


Abbreviation 


A 


Definition 
ADD adds modules to a library file. 


The pathname? can be an object file or a library file. 


The pathname2 is the destination library file. The library must exist before the ADD 
command is given; it may contain other modules. 


If pathname? is an object file produced by a translator, LINK86, or LOC86, then all 
modules contained within the object file will be added to the designated library. 


If pathname2 is a library file, it may be specified with or without the module name 
list. If no module name list is specified, all modules contained in the source library 
will be added to the destination library. If the module name list is specified, then 
only the modules specified within the parentheses are added to the destination 
library. 
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Syntax 


CREATE pathname 


Abbreviation 


C 


Definition 
CREATE creates a library file with the specified pathname. 


Notes 


e If a file with the specified pathname already exists, the library will not be 
created and an error message will be provided. 
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Syntax 


DELETE pathname (module name [,...]) 


Abbreviation 


D 


Definition 
DELETE removes modules from a library file. Modules can be deleted from only 
one library at a time. 


Notes 


None 
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Syntax 
EXIT 


Abbreviation 


E 


Definition 
EXIT terminates a session with LIB86 and returns control to the operating system. 


Notes 


¢ LIB86 disassembles libraries into an internal form. The library is not 
reconstituted until the EXIT command is processed. Therefore significant I/O 
will take place following an EXIT command. 
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Syntax 

LIST {pathnamet| (module name [,...])]} [,...][T0 pathname2] 
[PUBLICS] 

Abbreviation 


L [P] 


Definition 


LIST prints the names of modules, and optionally the public symbols contained in 
those modules, to the specified output pathname. 


The pathnamet is the library whose modules are to be listed. 
The module name, if specified, identifies the modules to be listed. 


TO pathname2 identifies the device or file to receive the listing. If it is not specified, 
the listing is directed to the console output device. 


PUBLICS indicates that, in addition to the module names, all public symbols con- 
tained within the module will also be listed. PUBLICS may be abbreviated as ‘P’. 


Notes 


None 


CHAPTER 5 


LOC86 


LOC86 changes a relocatable 8086 object module into an absolute object module. 
As figure 5-1 illustrates, LOC86 takes a single 8086 object module as input and out- 
puts a located object file and, optionally, a print file. The print file output contains 
diagnostic information. The object file contains absolute object code. 


This chapter provides details concerning the LOC86 invocation, controls, and print 
file. For definition of file-naming and syntax notation conventions used in this 
chapter, refer to Notational Conventions following the Preface. For a summary of 
the LOC86 controls and information on error and warning messages that may be 
produced, refer to Appendix G. For details concerning LOC86 segment support 
capabilities, refer to Appendix C. 


INVOCATION 
LINE CONTROLS 


a 


OBJECT ABSOLUTE 
LOC86 OBJECT 
MODUES MODULE 
ee | 
CONSOLE 
MESSAGES 
Figure 5-1. LOC86 Input and Output Files 121616-6 


LOC86 Invocation Line 


The general syntax for the invocation line is: 
|directory-name|L0C86 input file|[T0 object file|[controls] 


The input file is a file containing an object module to be located. It is usually, but 
not necessarily, the output from LINK86. 


TO object file specifies the file to receive the located object module. In most cases 
this is an executable file. If object file is not specified, then output will be directed to 
a file that has the same pathname as the input file, except it will have no extension. 


The controls may be any subset of the controls described in the next section. 


LOC86 Controls 


The controls are described in table 5-1. 


If you specify the same control more than once in the same invocation line, only the 
last version entered counts. For example, if you enter NOMAP, and then later 
decide you want a locate map, you can enter the MAP control without error. The 
second version of the control is recognized and the first is ignored. 


At the end of this document you will find operating system-specific examples of the 
LOC86 controls. Fold out the pages containing the examples relevant to your 
operating environment and use them in conjunction with the syntax conventions 
provided in this chapter. 
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Table 5-1. Summary of LOC86 Controls 


ADDRESSES( 
{SEGMENTS({segment{\class{\overlay]| 
(addr)}[,...]) | 
CLASSES(<{c/ass(addr)}[,...]) | 
GROUPS({group(addr)}{,...}) } 
[,---]) 


OBJECTCONTROLS( 
{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE}|....]) 


ORDER( OD Not applicable 
{SEGMENTS({segment|[ \class[\ overlay}|} (SM|CS) 
[---)I 
CLASSES({class[(segment {,...])|+ [,-.-])} [,...]) cS 


PRINT(object file .MP2) 


PRINT((pathname)] 
NOPRINT 


PRINTCONTROLS({LINES | NOLINES | PC Not applicable 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE}|....]) 


PUBLICS PUBLICS 


PURGE NOPURGE 
NOPURGE 
RESERVE({adar TO addr? [,...]) 


SEGSIZE( {segment \class|\overlay]]} 
(size)} [,...]) 


START({symbo! | paragraph,offset}) 
SYMBOLS 


NOSYMBOLS 


SYMBOLCOLUMNS( 11213143) 
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Syntax 


ADDRESSES ({SEGMENTS ( {segment name|\class name 
[\overlay name]] (address) } 
[,---]) | 
CLASSES ( {class name (address) }[,...]) | 
GROUPS ( {group name (address) }[,...])} 


[,---] 
) 


Abbreviation 


AD(SM|CS|GR) 


Default 
Not applicable 


Definition 


ADDRESSES allows you to override LOC86’s default address assignment 
algorithm. You may assign a beginning address to segments, classes, or groups. All 
addresses must follow Intel rules for integer representation. (These rules are the 
same as those used by ASM86 and PL/M-86.) The subcontrols, SEGMENTS, 
CLASSES, and GROUPS, identify exactly what elements of the input module are 
being assigned addresses. When assigning an address with the SEGMENTS sub- 
control, you may also specify the class name and overlay name of the particular 
segment. 


LOC86 attempts to detect and avoid conflicts whenever possible. If the specified 
address does not agree with the alignment attribute of the specified segment or the 
first segment in the specified class, then the address is ignored. If an absolute seg- 
ment is located at the address assigned to a class, then the class begins at the first free 
address after the absolute segment. If you assign a non-paragraph address to a 
group, LOC86 will assign the first paragraph address below the specified address. 


Notes 


e The subcontrols SEGMENTS, CLASSES, and GROUPS can be specified 
multiple times in a single ADDRESSES control. 

e If an address assignment causes a conflict with an ORDER control, a 
RESERVE control or an absolute segment, LOC86 generates an error message. 


e When locating bound object modules, you may not assign an address to a 
segment in a group. 
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Syntax 
BOOTSTRAP 


Abbreviation 


BS 


Default 
Not applicable 


Definition 


BOOTSTRAP indicates that the code for a long jump to the module’s start address 
should be placed at location OFFFFOH, when the module is loaded. This is the first 
instruction executed by the 8086 after reset. If the input module has no start address 
and none is specified in the START control, LOC86 will generate an error message. 


Notes 
e See also the START and INITCODE controls. 


iAPX 86,88 Family Utilities COMMENTS/NOCOMMENTS 


Syntax 


COMMENTS 
NOCOMMENTS 


Abbreviation 


CM 
NOCM 


Default 
COMMENTS 


Definition 


COMMENTS allows object file comment records to remain in the output module. 
The NOCOMMENTS control removes all comment records except those designated 
as non-purgable. 


Comment records are added to the object module for various reasons. All 
translators add a comment record to the object files they prdduce. The record iden- 
tifies the compiler or assembler that produced the object file. 


Comment records are superfluous to the production of executable code and may be 
removed at any time during the development process, or left in the file. 


Notes 


e See PRINTCONTROLS, OBJECTCONTROLS, and PURGE. 


e Comment records should not be removed when you submit an object file ina 
Software Problem Report. 


e¢ NOCOMMENTS will decrease the size of the output object module. 
e COMMENTS has no effect on the print file. 


«5-5 


INITCODE/NOINITCODE 


Syntax 

INITCODE[ (address) | 
NOINITCODE 
Abbreviation 

Ic 

NOIC 

Default 
INITCODE(200H) 


Definition 


iAPX 86,88 Family Utilities 


INITCODE causes LOC86 to create a new segment that contains code to initialize 
the segment registers. The optional address argument specifies the physical address 
of the code that performs this initialization. If no address is specified, the initializa- 
tion code will be placed at 200H. The equivalent assembly language code is shown 


below: 


STACKFRAME OW stack frame 

DATAFRAME DW data frame 

EXTRAFRAME OW extra frame 
CLI 


MOV SS, CS:STACKFRAME 
MOV SP, stack offset 

MOV ODS, CS:DATAFRAME 
MOV ES, CS:EXTRAFRAME 


JMP = program start 


Notes 


e The initialization code segment is created only if a register initialization record 
for 8086 segment registers exists in the input. These register initialization 
records are automatically produced by 8086-based translators for main 


modules. 


e If the area of memory used by the INITCODE default is reserved, LOC86 


places the initialization code above the reserved space. 
e If created, the new segment is called ??LOC86__INITCODE. 
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Syntax 


LINES 
NOLINES 


Abbreviation 


LI 
NOLI 


Default 


LINES 


Definition 


LINES allows line number information to remain in the object file. In-circuit 
emulators and other debuggers use this information; it is not needed to produce 
executable code. The NOLINES control removes this information from the output 
file. 


Notes 


e The scope of the LINES control can be modified with PRINTCONTROLS and 
OBJECTCONTROLS. 


e See the PURGE control. 
e NOLINES will decrease the size of the output object file. 
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Syntax 

MAP 

NOMAP 
Abbreviation 
MA 

NOMA 

Default 

MAP 


Definition 


MAP causes LOC86 to produce a locate map for the output module and add it to the 
print file. For all segments in the module the map shows the complete name (seg- 
ment name, class name, and overlay name), size, alignment, start address, and stop 
address. A more complete description of the locate map and the rest of the print file 
is at the end of this chapter. 


Notes 
¢ MAP can be overridden by the NOPRINT control. 
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Syntax 


NAME (module name) 


Abbreviation 


NA 


Default 


Module retains its current name. 


Definition 
NAME assigns the specified module name to the output module. If NAME is not 
specified, then the output module retains its current name. 


The module name may be up to 40 characters long. It may be composed of any of 
the following characters in any order: 


? (question mark) 
@ (commercial at) 
: (colon) 

. (period) 

__ (underscore) 
Ay B Cac ZZ 
0,1, 2,..., 9. 


Lower case letters may be used, but they are automatically converted to upper case. 


Notes 


e¢ NAME does not affect the output file’s name, only the module name in the 
output module’s header record. 


NAME 
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Syntax 


OBJECTCONTROLS({LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} 


[1+] 
) 


Abbreviation 


oc 


Default 
Controls apply to both the print file and the object file. 


Definition 


OBJECTCONTROLS causes the controls specified in its arguments to be applied to 
the object file only. Comment records, line number records, local and public symbol 
records, and symbol type records are selectively included or excluded from the 
object file. This will not affect the print file and the information contained in it. 


Notes 


e If you specify an invalid control in the arguments to OBJECTCONTROLS, 
LOC86 generates an error message. 

e You may specify a control or control pair more than once within 
OBJECTCONTROLS, but only the last version specified counts. 

e You may abbreviate the controls used within OBJECTCONTROLS. 

e When you _ specify a control in both OBJECTCONTROLS and 
PRINTCONTROLS, it will have the same effect as specifying it once outside of 
these controls. . 


iAPX 86,88 Family Utilities ORDER 


Syntax 
ORDER (C{LSEGMENTS ( {segment name|\class name|\overlay name}]|} 
[ee]: 
CLASSES (\ {class name[(segment name {,...])]} [,...])} 
[,---}) 
Abbreviation 


ODCSM|CS]) 


Default 
Not applicable 


Definition 


ORDER specifies a partial or complete order for segments, classes, and the segments 
within a class. Segments and classes listed in ORDER are located before any other 
relocatable segment. 


The subcontrol SEGMENTS indicates that the list of segment names shall be 
ordered. 


The segment name identifies the specific segments to be ordered. The \class name 
and \overlay name may be used to resolve conflicts with duplicate segment names. 
If \overlay name is specified, the \class name is required. 

If one of the segments specified is not contained in the designated group, an error 
message is generated. 


Notes 
e §6©See ‘‘LOC86’s Algorithm for Locating Segments’’ at the end of this chapter. 
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Syntax 


PRINT| (pathname) | 
NOPRINT 


Abbreviation 


PR 
NOPR 


Default 


PRINT (object file .MP2) 


Definition 


PRINT allows you to direct the locate map symbol table and other diagnostic 
information to a particular file. If the PRINT control is not specified or if the con- 
trol is given without an argument, the print file will have the same pathname as the 
output file except the extension will be .MP2. NOPRINT prevents the creation of 
this file. 


Notes 


e The discussion at the end of this chapter describes the contents of the print file. 


e See also MAP, SYMBOLCOLUMNS, LINES, SYMBOLS, PUBLICS, and 
PRINTCONTROLS. 
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Syntax 


PRINTCONTROLS({LINES | NOLINES 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} 


ee 
) 


Abbreviation 


PC 


Default 
Controls apply to both the print file and the object file. 


Definition 


PRINTCONTROLS causes the controls specified in its arguments to be applied to 
the print file only. Line number information, and local and public symbol informa- 
tion are selectively included or excluded from the print file. This will not affect the 
object file or the information contained in it. 


Notes 
e If you specify an invalid control in the arguments to PRINTCONTROLS, 
LOC86 generates an error message. 


e You may specify a control in OBJECTCONTROLS more than once, but only 
the last version specified counts. 


e You may abbreviate the controls used within PRINTCONTROLS. 


e¢ When you specify a control in both PRINTCONTROLS and 
OBJECTCONTROLS, it will have the same effect as specifying it once outside 
of these controls. 


P U B L | C S / N O p U B L | C S iAPX 86,88 Family Utilities 


Syntax 
PUBLICS 
NOPUBLICS 
Abbreviation 
PL 

NOPL 

Default 


PUBLICS 


Definition 


PUBLICS causes the public symbol records to be kept in the object file and the 
corresponding information to be placed in the print file. 


Notes 
© The scope of PUBLICS can be modified by PRINTCONTROLS and 
OBJECTCONTROLS. 


¢ NOPUBLICS will reduce the size of the output object file; however, public 
symbol records are used by debuggers. 


e See the PURGE control. 


iAPX 86,88 Family Utilities PURGE/NOPURGE 


Syntax 


PURGE 
NOPURGE 


Abbreviation 


PU 
NOPU 


Default 
NOPURGE 


Definition 


PURGE is exactly the same as_ specifying NOLINES, NOSYMBOLS, 
NOCOMMENTS, and NOPUBLICS. NOPURGE in the control list is the same as 
specifying LINES, SYMBOLS, COMMENTS, and PUBLICS. 


PURGE removes all of the public and debug information from the object file and 
the print file. It will produce the most compact object file possible. The records that 
would be included by NOPURGE are useful to debuggers and in-circuit emulators, 
but otherwise they are unnecessary for producing executable code. 


Notes 
e PRINTCONTROLS and OBJECTCONTROLS can be used to modify the 
scope of PURGE. 
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Syntax 


RESERVE ({address1 T0 address2} |,...]) 


Abbreviation 


RS 


Default 


All of memory is assumed available. 


Definition 


RESERVE prevents LOC86 from locating segments in certain areas of memory. 
LOC86 will not use all memory addresses from address? to address2 inclusive; 
address?! must be less than or equal to address2. 


Notes 
e If an absolute segment uses a reserved memory area, a warning message is 
generated. 


e Reserved areas may overlap. 
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Syntax 


SEGSIZE( {segment name[\class name|\overlay name]| (size) } 


Abbreviation 


$$ 


Default 
Not applicable 


Definition 
SEGSIZE allows you to specify the memory space used by a segment. 


The segment name may be any segment contained in the input module. 


The size is a 16-bit number that LOC86 uses to change the size of the specified seg- 
ment. There are three ways of specifying this value: 


e + indicates that the number should be added to the current segment length. 


e — indicates that the number should be subtracted from the current segment 
length. 


e No sign indicates that the number should become the new segment length. 


Notes 
e LOC86 issues a warning message when SEGSIZE decreases the size of a 
segment. 


SEGSIZE 


START iAPX 86,88 Family Utilities 


Syntax 


START ( {public symbol! | paragraph , offset} ) 


Abbreviation 


ST 


Default 


The start address designated in the input module 


Definition 

START allows you to specify the start address of your program. 

If you specify public symbol, that symbol must be defined within the input module. 
The paragraph value initializes the CS register and the offset value initializes the IP 


in an 8086 long jump when your program is started. 


Notes 
e See the BOOTSTRAP and INITCODE controls. 
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Syntax 


SYMBOLS 
NOSYMBOLS 


Abbreviation 


SB 
NOSB 


Default 
SYMBOLS 


Definition 


SYMBOLS specifies that all local symbol records shall be included in the object file, 
and information concerning local symbols will also appear in the symbol table con- 
tained in the print file. Local symbol records are used by debuggers and in-circuit 
emulators. 


Notes 

e The scope can be modified by OBJECTCONTROLS and PRINTCONTROLS. 
e NOSYMBOLS will decrease the size of the output object file. 

¢ See the PURGE control. 
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Syntax 
SYMBOLCOLUMNS ({1|2]3]4}) 


Abbreviation 


SC 


Default 
SYMBOLCOLUMNS (2) 


Definition 


SYMBOLCOLUMNS indicates the number of columns to be used when producing 
the symbol table for the object module. Two columns fit on a 78-character line; four 
columns fit on a single 128-character line printer line. 


Notes 


None 
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LOC86’s Print File 


The print file is always created unless you specify NOPRINT. The optional argu- 
ment to PRINT designates the name of the print file. The default print file is the 
object file with the extension .MP2. 


The print file may contain as many as three parts: 
e Asymbol table 

e Amemory map 

e Anerror message list 


The symbol table is included in the print file when a PUBLICS, LINES, or 
SYMBOLS control is in effect. The memory map is controlled by the 
MAP/NOMAP control. Error and warning messages, if any, are always added to 
the print file. 


The Symbol Table 


LOC86 produces a symbol table when any or all of the symbol controls (LINES, 
SYMBOLS, and PUBLICS) are in effect. No symbol table will be produced when 
PURGE is in effect for the print file. 


Figure 5-2 shows LOC86’s symbol table with the SYMBOLCOLUMNS set at 2 (the 
default). 


BASE is usually a 4-digit hexadecimal number that is the base address of the group 
that contains the symbol. If the base is the stack, then STACK is used instead of a 
number. If the symbol is based on another symbol’s value, then the BASE and 
OFFSET values for that symbol are given. 


OFFSET is a 4-digit hexadecimal number that is the offset of the symbol or line 
from BASE, or from the current BP for stack symbols. 


.To compute the physical address of the specified symbol you would use the follow- 
ing equation: 


(BASE * 10H) + OFFSET = Physical Address 


Of course, the physical address of the symbols whose base is the STACK, or symbols 
that are based on another symbol’s value, cannot be computed until run-time. 


TYPE describes the kind of symbol it is. There are four possible entries in the TY PE 
column: 


BAS based on another symbol’s value 
LIN line (not a symbol) 

PUB public symbol 

SYM local symbol - 


SYMBOL field contains the name of the symbol or number of the line. If the 
SYMBOLCOLUMNS value is I, this field is 40 characters wide. If the 
SYMBOLCOLUMNS value is 2 or more, then this field is 16. characters wide. H the 
symbol name is longer than the width of the entry, then the name is hyphenated and 
continued in the SYMBOL field on the next line. 
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systemid 8Q86 LOCATER, Vxy 

INPUT FILE: pathnamet 

OUTPUT FILE: pathname2 = 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 


DATE: MM/DD/YY TIME: HH:MM:SS 


SYMBOL TABLE OF MODULE ROOT 


BASE 


OOBBH 
OOBBh 
OOBBH 
OOBBH 


OOBBH 


OObBH 
QOBBH 
OOBBH 


OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 


OOBBH 
OOBBH 


MODULE = 
BASE 


OOBBH 
OOBBH 
0020H 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBH 
OOBBER 
OOBBH 
OOBBR 


OF FSET 


076CH 
OO1EH 
00548 
0160H 


0179R 


0068H 
00748 
0072H 


0050H 
OO4AH 
003AH 
0032H 
00368 


0026H 
0O3EH 


ROOT 
OF FSET 


OFAQH. 
001CH 
OOF7H 
0020H 
00248 
00288 
002CH 
00308 
0034H 
003848 
003CH 
0O40H 
OO44H 
004868 
004CH 
0050H 
00548 


TYPE 


PUB 
PUB 
PUB 
PUB 


PUB 


PUB 
PUB 
PUB 


PUB 
PUB 
PUB 
PUB 
PUB 


PUB 
PUB 


SYM 
SYM 
SYM 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 
LIN 


SYMBOL 


BINDCONTROL 
BUFBASE 
CLASHNODEBASE 
COMMENTSCONTROL 


DEBUGTOGGLE 


EXCEPTION 
FBLOCKBASE 
FBLOCKLISITAIL 


FBNODEBASE 
FENODEBASE 
FIRSTBNODEP 
FIRSTGRNODEP 
FIRSTOVNODEP 


PIRSTSGNODEP 
GRNODEBASE 


SYMBOL 


MEMORY 
BUFLEN 
ERROR 
LASTNMNODEP 
LASTSGNODEP 
LASTTDNODEP 
LASTEXNODEP 
LASTGRNODEP 
LASTOVNODEP 
LASTBNODEP 
SGNODEBASE 
SYNODEBASE 
TDNODEBASE 
GVNODEBASE 
FDNODEBASE 
FBNODEBASE 
CLASHNODEBASE 


SIGNONMSG 
INITIALIZEINPUT 
CLOSEFBLOCKFILE 

10 

V4 

75 


OFFSET 


0052H 
001CH 
0066H 
O177H 


OOADK 


OO4EH 
OO70H 
0143H 


OO4CH 
OO46H 
OO2EH 
0022H 
0056H 


OO2AH 
OB52H 


OFFSET 


0006H 
OO1EH 
OOFEH 
0022H 
0026H 
OO2AH 
002ER 
0032H 
0036H 
OO3AH 
O03EH 
OO4%2H 
OO46H 
O04 AH 
OO4ER 
0052H 
0056H 
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TYPE SYMBOL 


PUB SBNODEBASE 

PUB BUFLEN 

PUB COCONN 

PUB CURRENTOVERLAYNU 
-M 

PGB DEFAULTPRIFILENA 
-ME 

PUB FANODEBASE 

PUB FBLOCKLISTHEAD 

PUB FBLOCKSEQUENCENU 
~MBER 

PUB FDNODEBASE 

PUB FFNODEBASE 

PUB FIRSTEXNODEP 

PUB FIRSTNMNODEP 

PUB FIRSTRENAMEBLOCK 
-P 

PUB FIRSTTDNODEP 

PUB HIGHESTDATALOCAT 
-ION 


TYPE SYMBOL 


SYM COPYRIGHT 
SYM BUFBASE 
SYM WARNING 
SYM FIRSTNMNODEP 
SYM FIRSTSGNODEP 
SYM FIRSTTDNODEP 
SYM FIRSTEXNODEP 
SYM FIRSTGRNODEP 
SYM FIRSTOVNODEP 
SYM FIRSTBNODEP 
SYM GRNODEBASE 
SYM NMNODEBASE 
SYM FFNODEBASE 
SYM PENODEBASE 
SYM FANODEBASE 
SYM BNODEBASE 
SYM FIRSTRENAMEBLOCK 
=-P 


SYM PRINTNAME 

SYM OPENFBLOCKFILE 
LIN 

LIN 


Figure 5-2. LOC86 Symbol Table 
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The Memory Map 


The memory map supplies useful information about segment placement and address 
assignment. Figure 5-3 shows LOC86’s memory map. 


The map consists of three parts: 
e Header 

e Segment map 

¢ Group map 


The header includes the input module name and the start address. 


The segment map is a table with six columns. From left to right the columns show: 
e theSTART address of the segment 

e the STOP address of the segment 

e the LENGTH of the segment 

e the ALIGNMENT attribute of the segment 

e the NAME of the segment 

e the CLASS of the segment 

e the OVERLAY of the segment 


A ‘‘C’’ printed between the STOP and LENGTH columns indicates that two 
segments have overlapping memory locations; a warning message is also issued. 


A segment may have any one of the following alignment attributes: 


absolute 

byte 

paragraph 

member of an LTL group 
page 

word 

in-page 


AELeVEMH oY 


MEMORY MAP OF MODULE ROOT 


MODULE START ADDRESS PARAGRAPH = 0020H OFFSET = 0002H 
SEGMENT MAP 


START STOP LENGTH ALIGN NAME CLASS OVERLAY 


00200H OOBB5H O9B6H CODE CODE 
OOBB6H OOBCBH 0016H CONST CONST 
OOBCCA 01703H 0538H DATA DATA 
01704H 0 1B45H O442H STACK STACK 
01B50K 01B50H 0O000H ??SEG 

01B50H 01850 0000H MEMORY MEMORY 


GROUP MAP 


ADDRESS GROUP OR SEGMENT NAME 
002008 CGROUP 

CODE 
OOBBOH DGROUP 

CONST 

DATA 

STACK 

MEMORY 


Figure 5-3. LOC86 Memory Map 
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In-page alignment means that the entire segment must be resident within a single 
256-byte page. The address of the first byte in any page has zeros in the first two 
hexadecimal digits (OOH, 100H, 200H,... OFFFOOH). 


The group map has two columns: the first is the physical address (five-digit hexa- 
decimal number) of the beginning of the group; the second column is the group 
name, followed by the segments contained in that group. The segment names con- 
tained within a given group are listed in the same column but indented slightly. 


Error and Warning Messages 


The error and warning messages are listed consecutively as the error situations are 
encountered. 


See the discussion of the interpretation of individual messages in Appendix F. 


LOC86’s Algorithm for Locating Segments 


Assuming that there are no errors in the invocation line or input module, LOC86 
locates an input module in three stages. 


1. All absolute segments are removed from the list of segments contained in the 
module. 


The remaining relocatable segments are ordered into a sequential list. 


3. The relocatable segments are then given absolute addresses according to each 
segment’s alignment, size, and memory attribute. 


Absolute Segments 


When LOC86 encounters an absolute segment, LOC86 removes the segment from a 
list of input segments and reserves the memory area used by that segment. LOC86 
maintains a map of free memory. Each time an absolute segment is encountered, the 
memory space used by that segment is removed from the memory map. A segment 
can become absolute in one of three ways: 


1. It may be assigned an absolute address by the translator. 
2. It may be explicitly specified in an ADDRESSES control. 


3. It may become absolute implicitly. If an absolute segment is specified in an 
ORDER control, then all other segments referred to in that control, either by 
segment name or by class name, are treated as absolute. 


Segment Ordering 

After all memory used by absolute segments has been removed from LOC86’s free 
memory map and before LOC86 begins assigning addresses to the remaining 
relocatable segments, LOC86 prepares an ordered list of all relocatable segments. 


All relocatable segments specified in an ORDER control are placed at the head of 
the list. 
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After all ORDER controls, if any, have been processed, LOC86 adds the relocatable 
segments that remain to the end of the list. If the first segment not previously used 
has a class name, then all other segments with the same class name are added to the 
list. After all segments of the class have been added to the list, then the next segment 
is added to the list. 


This process continues until all segments have been added to the ordered list. 


NOTE 


Memory segments do not adhere to this process — a memory segment is 
always located at the top of memory, if possible. If an input module con- 
tains more than one memory segment, only the first is placed at the top of 
memory; the other segments are treated as any other relocatable segment. 


Assigning Addresses to Relocatable Segments 


Once LOC86 completes the ordered list of relocatable segments, it begins assigning 
addresses. LOC86 will never assign addresses that conflict with the location of 
absolute segments or the RESERVE control or between 00H and 200H, since that 
area is reserved for interrupt routines. 


Starting at location 200H, LOC86 scans free memory to find an area in which the 
first segment will fit. When LOC86 finds a suitable address, it assigns it to the seg- 
ment and removes that area from free memory. LOC86 then scans free memory for 
an area that will fit the next segment in the ordered list. LOC86 begins scanning at 
the end of the previous segment. 


IF LOC86 reaches the end of memory and all of the relocatable modules have not 
been located, it makes an additional scan through free memory. The scanning pro- 
cess continues until all modules have been located. 


LOC86’s Algorithm for Locating Modules 
Containing Overlays 


LOC86 locates programs with overlays in much the same way as it handles programs 
that do not contain overlays. However, there are some differences. 


1. Segments contained in the root and each overlay are ordered separately. 


2. Segments that are common to both the root and overlays (e.g.,STACK and 
- MEMORY) are put at the end of the list of relocatable segments. 


3. Segments in the root are located at the lowest available addresses in memory. 


Segments contained in the overlays are located at the first available address 
above the root. 


5. Segments common to the root and overlays are located immediately above the 
largest overlay in the file. . 


Figure 5-4 illustrates how LOC86 treats two PL/M-86 programs that use overlays. 
Figure 5-4a shows how segments are located when the modules are compiled with the 
LARGE model. Figure 5-4b shows how segments are located when the modules are 
compiled with the SMALL model of segmentation. 
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CHAPTER 6 


OH86 converts 8086 absolute object modules to 8086 hexadecimal format. The 
input module must be in absolute format, and it may not contain overlays or register 
initialization records. 


Figure 6-1 illustrates the object-to-hexadecimal conversion process. Any errors 
encountered during execution are displayed at the console output device. 


For definition of file-naming conventions and syntax notation, refer to Notational 
Conventions following the Preface. For information on error and warning messages 
which may be produced, refer to Appendix H. 

The general syntax for the invocation line is: 

[directory-name]0H86 input file|T0 output file] 

The input file contains an 8086 absolute object module. 

TO output file designates the file to receive the 8086 hexadecimal format. If output 
file is not specified, then output is directed to a file that has the same pathname as 


the input list, but its extension is HEX. 


At the end of this document you will find operating system-specific examples of the 
OH86 invocation. 


ABSOLUTE pos orte 
OBJECT | Ones L———»j HEX 
MODULE : ates 
aesetnateier | 
CONSOLE 
MESSAGES 
Figure 6-1. OH86 Input and Output Files 121616-9 
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FILE FORMATS 


introduction 


The 8086 Absolute Object File Format herein described is a proper subset of the full 
8086 Object File Formats. An absolute object file consists of a sequence of records 
defining a single absolute module. An absolute module is defined as a collection of 
absolute object information that is specified by a sequence of object records. 


Definitions 


This section defines certain terms fundamental to 8086 Relocation and Linkage 
(R&L). The terms are ordered not alphabetically, but so you can read forward 
without forward references. 


Definition of Terms 
OMF—acronym for Object Module Formats 
R&L—acronym for Relocation and Linkage 


MAS—acronym for Memory Address Space. The 8086 MAS is one megabyte 
(1,048,576 bytes). Note that the MAS should be distinguished from actual memory, 
which may occupy only a portion of the MAS. 


MODULE-— an “‘inseparable’’ collection of object code and other information pro- 
duced by a translator or by the LINK86 program. When a distinction must be made: 


T-MODULE—denotes a module created by a translator, such as PL/M-86 or 
ASM86, and 


L-MODULE—denotes a module created by LINK86 from one or more constituent 
modules. (Note that modules are not ‘‘created’’ in this sense by the iAPX86,88 
Locater, LOC86; the output module from LOC86 is merely a transformation of the 
input module). 


Two observations about modules must be made: 


1. Every module must have a name, so that the iAP X86,88 Librarian, LIB86, has a 
handle for the module for display to the user. (If there is no need to provide a 
handle for LIB86, the name may be null.) Translators provide names for T- 
modules, providing a default name (possibly the file name or a null name) if 
neither source code nor user specifies otherwise. 


2. Every T-module in a collection of modules linked together may have a different 
name, so that symbolic debugging systems can distinguish the various symbols. 
This restriction is not required by R&L and is not enforced by it. 


FRAME-—a contiguous region of 64K of MAS, beginning on a paragraph boundary 
(i.e., on a multiple of 16 bytes). This concept is useful because the content of the 
four 8086 segment registers define four (possibly overlapping) FRAME’s; no 16-bit 
address in the 8086 code can access a memory location outside of the current four 
FRAME’s. The FRAME starting at address OOOOH is FRAME 0. 
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Module Identification 


4 


In order to determine that a file contains an object program, a module header record 
will always be the first record in a module. There are two kinds of header records 
and each provides a module name. The additional functions of the header records 
are explained below. 


A module name may be generated during one of two processes: translation or link- 
ing. A module that results from translation is called a T MODULE. A T-MODULE 
will have a T-MODULE HEADER RECORD (THEADR). A name may be 
provided in the THEADR record by a translator. This name is then used to identify 
the progenitor of all debug information found in the T-MODULE. The name may 
be null, i.e., of length zero. 


A module that results from linking and locating is called an L-MODULE. An 
L-MODULE will always have an LMODULE HEADER RECORD (LHEADR) or 
an R-MODULE HEADER RECORD (RHEADR). In the LHEADR or RHEADER 
record a name is also provided. This name is available for use to refer to the module 
without using any of its constituent T-MODULE names. An example would be two 
T-MODULES, A and B, linked together to form L-MODULE C. L- MODULE C 
will contain two THEADR records and will begin with an LHEADR record with the 
name C provided by the linker as a directive from the user. The L- MODULE C can 
be referred to by other tools such as the library manager without having to know 
about the originating module’s names, yet the originating module’s names are 
preserved for debugging purposes. 


Module Attributes 


In addition to a name, a module may have the attribute of being a main program as 
well as having a specified starting address. 


If a module is not a main module yet has a starting address, then this value has been 
provided by a translator, possibly for debugging purposes. A starting address 
specified for a non-main module could be the entry point of a procedure, which may 
be loaded and initiated independent of a main program. 


Physical Segment Definition 


A module is defined as a collection of data bytes defined by a sequence of records 
produced by-a translator. The data bytes represent contiguous regions of memory 
whose contents are determined at translation time. 


Physical Segment Addressability 


The 8086 addressing mechanism provides segment base registers from which a 64K 
byte region of memory, called a Frame, may be addressed. There is one code seg- 
ment base register (CS), two data segment base registers (DS, ES), and one stack seg- 
ment base register (SS). 
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Data 


The data that defines the memory image represented by a module is maintained in 
two varieties of DATA records: PHYSICAL ENUMERATED DATA RECORD 
(PEDATA) and PHYSICAL ITERATED DATA RECORD (PIDATA). Both 
records specify the data to be loaded into a contiguous section of memory. The start 
address of this contiguous section is given in the record. PEDATA records contain 
an exact byte-by-byte copy of the desired memory image. The PIDATA record dif- 
fers in that the data bytes are represented within a structure that must be expanded 
by the loader. The purpose of the PIDATA record is to reduce module size by 
encoding repeated data rather than explicitly enumerating each byte, as the 
PEDATA record does. 


Record Syntax 


The following syntax shows the valid orderings of records to form an absolute 
module. In addition, the given semantic rules provide information about how to 
interpret the record sequence. The syntactic description language used herein is 
defined in Wirth: CACM, November 1977, V20, N 11, pg. 822-823. 


absolute__object__file =module. 
module =tmod | Imod | omod. 
tmod =THEADR [REGINT]content_def mod__tail. 
Imod =LHEADR [REGINT]t_component mod__tail. 
omod =RHEADR {OVLDEF}[REGINT] o__component 
{COVLDEF} mod_ tail. 
o__component =t_component ENDREC. 
t_component =[THEADR] content_def 
content_def =PEDATA | PIDATA. 
mod__tail =[REGINT] MODEND. 
NOTE 


The character strings represented by capital letters above are not literals but 
are identifiers that are further defined in the section defining the Record 
Formats. 


One module may not contain more than one REGINT record and more than one 
OVLDEF sequence. If a REGINT record and an OVLDEF sequence exist, the 
REGINT record must immediately follow the OVLDEF sequence. 


A proper Absolute Object File produced by Intel products will contain at least the 
above record types. It may also contain other record types which, if present, will 
follow the Module Header record and precede the Module End record. These other 
record types fall into two categories: 


1. Extraneous, containing information not pertinent to an absolute loader. The 
record numbers in this category are: 
72H, 74H, 7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH 

2. Erroneous, containing information about relocation, indicating that the object 


module is not yet in absolute form or that erroneous record types exist. The 
record numbers in this category are all other record type numbers. 
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Record Formats 


The following pages present diagrams of Record Formats in schematic form. Here is 
a sample, to illustrate the various conventions: 


Sample Record Format (SAMREC) 


RECORD 
LENGTH 


| Title and Official Abbreviation 


At the top is the name of the Record Format described, together with an official 
abbreviation. To promote uniformity among various programs, the abbreviation 
should be used in both code and documentation. The abbreviation is always six 
letters. 


The Boxes 


Each format is drawn with boxes of two sizes. The narrow boxes represent single 
bytes. The wide boxes represent two bytes (or one word) each. In the object file, the 
low order byte of a word value comes first. The wide boxes with four vertical bars in 
the top and bottom represent 4-byte fields. The wide boxes with three dots in the top 


- and bottom represent a variable number of bytes, one or more, depending upon 


content. 


Rec Typ 


The first byte in each record contains a value between 0 and 255, indicating the type 
of record. 


Record Length 


The second field in each record contains the number of bytes in the record, exclusive 
of the first two fields. 


Name 


Any field that indicates a “‘NAME?”’ has the following internal structure: the first 
byte contains a number between 0 and 40, inclusive, that indicates the number of 
remaining bytes in the field. The remaining bytes are interpreted as a byte string; 
each byte must represent the ASCII code of a character drawn from this set: 


[2@ :.__0123456789A BCDEFGHIJKLMNOPQRSTUVWXYZ |] 


Most translators will choose to constrain the character set more strictly; the above 
set has been chosen to ‘‘cover’’ that required by all current processors. 
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Repeated Fields 


Some portions of a Record Format contain a field or series of fields that may occur 
an indefinite number of times (zero or more). Such fields are indicated by the 
“‘repeated’’ or ‘‘rpt’’ brackets below the boxes. 


Similarly, some portions of the Record Format are present only if some given condi- 
tion obtains; these fields are indicated by similar ‘‘conditional’’ brackets below the 
boxes. 


Chk Sum 


The last field in each record is a check sum, which contains the two’s complement of 
the sum (modulo 256) of all other bytes in the record. Therefore, the sum (modulo 
256) of all bytes in the record equals 0. 


Bit Fields 


Descriptions of contents of fields will sometimes get down to the bit level. Boxes 
with vertical lines drawn through them represent bytes or words; the vertical lines in- 
dicate bit boundaries; thus this byte has three bit-fields of three, one, and 
four bits: 


Ignored Records 


REC RECORD IGNORE CHK 
TYP LENGTH THIS SUM 
PART 


All record types that may be in an object module that provide information not perti- 
nent to an absolute loader must be ignored. They may all be treated as if they have 
the above format. Records in this category have REC TYP in the set 72H, 74H, 
7AH, 7CH, 7EH, 88H, 8CH, 8EH, 90H, 92H, 94H, 96H, 98H, 9AH, 9CH. 


T-Module Header Record (THEADR) 


eee 
REC RECORD T CHK 
TYP LENGTH MODULE SUM 
80H NAME 

eee 


Every module output from a translator must have a T-MODULE HEADER 
RECORD. Its purpose is to provide the identity of the original defining module for 
all debug information encountered in the module up to the following T-MODULE 
HEADER RECORD or MODULE END RECORD. 


This record can also serve as the header for a module; i.e., it can be the first record 
and will be for modules that are output from translators. 
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T-Module Name 
The T-MODULE NAME provides a name for the TTMODULE. 


L-Module Header Record (LHEADR) 


RECORD L CHK 
LENGTH MODULE SUM 
NAME 


A module created by LINK86 and LOC86 may have an L--MODULE HEADER 
RECORD. This record serves only to identify a module that has been processed 
(output) by LINK86 and/or LOC86. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to (by the LIB86 program, for example). 


L-Module Name 
The L-MODULE NAME provides a name for the L-Module. 


R-MODULE HEADER RECORD (RHEADR) 


eee eee 
R-MODULE OVERLAY CHK 
NAME INFO SUM 

eee eee 


Every module with overlays created by LINK86/LOC86 will have an RRMODULE 
HEADER RECORD. This record serves to identify a module that has been pro- 
cessed (output) by LINK86/LOC86. It also specifies the overlay count and the loca- 
tion of the Overlay Definition records. When several modules are linked to form 
another module, the new module requires a name, perhaps unique from those of the 
linked modules, by which it can be referred to. 


R-MODULE NAME 


The R-MODULE NAME provides a name for the R-Module. 


OVERLAY INFO 


The OVERLAY INFO field provides information on overlays in the module and has 
the following format: 


eee 

IGNORE 
THIS 

PART 


| | eee 
OVERLAY IGNORE 
RECORD THIS 
OFFSET PART 


The first subfield is a 5-byte field that should be ignored. 


OVERLAY 
RECORD 
COUNT 
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The OVERLAY RECORD COUNT subfield indicates the number of Overlay 
Definition Records in the module. 


The OVERLAY RECORD OFFSET subfield is a 4-byte field. It contains a 32-byte 
unsigned number indicating the location in bytes, relative to the start of the object 
file, of the first Overlay Definition Record in the Module. 


The last subfield is a 16-byte field that should be ignored. 


OVERLAY DEFINITION RECORD (OVLDEF) 


REC RECORD OVERLAY OVERLAY Z CHK 
TYP LENGTH NAME LOCATION SUM 
76H 


This Record provides the overlay name, the location of the overlay in the object file. 


A loader may use this record to locate the data records of the overlay in the object 
file. 


OVERLAY NAME 


The OVERLAY NAME field provides a name by which a collection of data records 
may be referenced for loading. 


OVERLAY LOCATION 


The OVERLAY LOCATION is a 4-byte field which gives the location in bytes 
relative to the start of the file of the first byte of the records in the overlay. 


Z 


The Z field is a reserved field. This field is required to be zero. 


END RECORD (ENDREC) 


REC RECORD END CHK 
TYP LENGTH TYP SUM 
78H 


This record is used to denote the end of a set of records such as records in an 
overlay. 
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END TYP 


This field specifies the type of the set. It has the following format: 


TYP is a two bit subfield that specifies the following types of ends: 


TYP TYPE OF END 
0 End of overiay 
1 (Reserved) 
2 (Hiegal) 
3 (Hlegal) 


REGISTER INITIALIZATION RECORD (REGINT) 


REGISTER CHK 
CONTENTS SUM 


RECORD 
LENGTH 


— repeated 


This record provides information about the 8086 registers/register-pairs: CS and 
IP, SS and SP, DS and ES. The purpose of this information is for a loader to set the 
necessary registers for initiation of execution. 


REG TYP 


The REG TYP field provides the register/register-pair name. It has the following 


format: 


REGID is a two bit subfield that specifies the name of the registers/register-pairs as 
follows: 


REGID REGISTER/REGISTERPAIR 
0 CS and IP 
1 SS and SP 
2 DS 
3 ES 
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REGISTER CONTENTS 


The REGISTER CONTENTS field has the following format: 


FRAME REGISTER 


NUMBER OFFSET 


L_ saanionatel 


The Z fields are reserved fields. They are required to be zero. 


The FRAME NUMBER field specifies a frame number that must be used to 
initialize the base register indicated by the REGID value. 


The REGISTER OFFSET field, present only if REGID <= 1, specifies an offset 


relative to the FRAME. This value is appropriate for the initialization of either the 
IP register (REGID = 0) or the SP register (REGID = 1). 


Module End Record (MODEND) 


RECORD START CHK 
LENGTH ADDRS SUM 


L conditional _| 


This record serves two purposes. It denotes the end of a module and indicates 
whether the module just terminated has a specified entry point for initiation of 
execution. If the latter is true, then the execution address is specified. 


Mod Typ 


This field specifies the attributes of the module. The bit allocation and their 
associated meanings are as follows: 


MATTR is a two-bit subfield that specifies the following module attributes: 


MATTR MODULE ATTRIBUTE 
0 Non-main module with no starting address 
1 Non-main module with starting address 
2 (invalid value for MATTR) 
3 Main module with starting address 
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Start Addrs 
The START ADRS field has the following format: 


FRAME OFFSET 


NUMBER 


FRAME NUMBER. This field specifies a frame number relative to which the 
module will begin execution. This value is appropriate for insertion into the CS 
register for program initiation. 


OFFSET. This field specifies an offset relative to the FRAME NUMBER that 


defines the exact location of the first byte at which to begin execution. This value is 
appropriate for insertion into the IP register for program initiation. 


Physical Enumerated Data Record (PEDATA) 


REC RECORD FRAME OFF CHK 
TYP LENGTH NUMBER SET SUM 
84H 

feng a rpt 


This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. 


Frame Number 


This field specifies a Frame Number relative to which the data bytes will be loaded. 


Offset 


This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte of the DAT field. Successive data bytes in the DAT 
field occupy successively higher locations of memory. The value of OFFSET is con- 
strained to be in the range 0 to 15 inclusive. If an OFFSET value greater than 15 is 
desired, then an adjustment of the FRAME NUMBER should be done. 


Dat 


This field provides consecutive bytes of an 8086 memory image. The number of 
DAT bytes is constrained only by the RECORD LENGTH field. The address of 
each byte must be within the frame specified by FRAME NUMBER. 


Physical Iterated Data Record (PIDATA) 


REC RECORD FRAME OFF 
TYP LENGTH NUMBER SET 
86H 
ee0e 
= sida 


This record provides contiguous data, from which a portion of an 8086 memory 
image may be constructed. It allows initialization of data segments and provides a 
mechanism to reduce the size of object modules when there are repeated data to be . 
used to initialize a memory image. 


ITERATED CHK 
DATA SUM 
BLOCK 
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Frame Number 


This field specifies a frame number relative to which the data bytes will be loaded. 


Offset 


This field specifies an offset relative to the FRAME NUMBER which defines the 
location of the first data byte in the ITERATED DATA BLOCK. Successive data 
bytes in the ITERATED DATA BLOCK occupy successively higher locations of 
memory. The range of OFFSET is constrained to be between 0 and 15 inclusive. If a 
value larger than 15 is desired for OFFSET, then an adjustment of FRAME 
NUMBER should be done. 


Iterated Data Block 
This repeated field is a structure specifying the repeated data bytes. It is a structure 


that has the following format: 


REPEAT 


COUNT CONTENT 


Repeat Count. This field specifies the number of times that the CONTENT portion 
of this ITERATED DATA BLOCK is to be repeated, and must be greater than zero. 


Block Count. This field specifies the number of ITERATED DATA BLOCKS that 
are to be found in the CONTENT portion of this ITERATED DATA BLOCK. If 
this field has value zero then the CONTENT portion of this ITERATED DATA 
BLOCK is interpreted as data bytes. 


If BLOCK COUNT is non-zero then the CONTENT portion of this ITERATED 
DATA BLOCK is interpreted as that number of ITERATED DATA BLOCKS. 


Content. This field may be interpreted in one of two ways, depending on the value 
of the previous BLOCK COUNT field. 


If BLOCK COUNT is zero, then this field is a one-byte count followed by the 
indicated number of data bytes. 


If BLOCK COUNT is non-zero, then this field is interpreted as the first byte of 
another ITERATED DATA BLOCK. 


NOTE 


From the outermost level, the number of nested ITERATED DATA 
BLOCKS is limited to 17: i.e., the number of levels of recursion is limited 
to 17. 


The address of each data byte must be within the frame specified by 
FRAME NUMBER. 


Hexadecimal Object File Format 
Hexadecimal object file format is a way of representing an object file in ASCII. 


The function of the utility program, 0H86, is to convert 8086 absolute object 
modules to 8086 hexadecimal object modules. 
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The hexadecimal representation of binary is coded in ASCII. For example, the eight- 
bit binary value 0011 1111 is 3F in hexadecimal. To code this ASCII, one eight-bit 
byte containing the ASCII code for 3(00110011 or 33H) and one eight-bit byte con- 
taining the ASCII code for F(0100 0110 or 46H) are required. This representation 
(ASCII hexadecimal) requires twice as many bytes as the binary. 


There are four different types of records that may make up an 8086 hexadecimal 
object file. They are: 


e Extended Address Record 
e Start Address Record 

e Data Record 

e End of File Record 


Each record begins with aRECORD MARK field containing 3AH, the ASCII code 
for colon (:). 


Each record has a REC LEN field which specifies the number of bytes of informa- 
tion or data which follows the RECTYP field of each record. Note that one byte is 
represented by two ASCII characters. 


Each record ends with a CHECKSUM field that contains the ASCII hexadecimal 
representation of the two’s complement of the eight-bit sum of the eight-bit bytes 
that result from converting each pair of ASCII hexadecimal digits to one byte of 
binary, from and including the RECORD LENGTH field to and including the last 
byte of the DATA field. Therefore, the sum of all the ASCII pairs in a record after 
converting to binary, from the RECORD LENGTH field to and including the 
CHECKSUM field, is zero. 


Extended Address Record 


REC REC CHK 
LEN ZEROES TYP USBA SUM 
*02’ *0000° ‘02’ 


The 8086 EXTENDED ADDRESS RECORD is used to specify bits 4-19 of the Seg- 
ment Base Address (SBA) where bits 0-3 of the SBA are zero. Bits 4-19 of the SBA 
are referred to as the Upper Segment Base Address (USBA). The absolute memory 
address of a content byte in a subsequent DATA RECORD is obtained by adding 
the SBA to an offset calculated by adding the Load Address Field of the containing 
DATA RECORD to the index of the byte in the DATA RECORD (0, 1, 2, ... n). 
The offset addition is done modulo 64K, ignoring a carry, so that offset wrap- 
around loading (from OFFFFH to 00000H) results in wrapping around from the end 
to the beginning of the 64K segment defined by the SBA. The address at which a par- 
ticular data byte is loaded is calculated as: 


SBA + ({[DRLA + DRI] MOD 64K) 
where 
DRLA is the DATA RECORD LOAD ADDRESS. 


DRI is the data byte index withina DATA RECORD. 
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When an EXTENDED ADDRESS RECORD defines the value of SBA, the 
EXTENDED ADDRESS RECORD may appear anywhere within an 8086 hexa- 
decimal object file. This value remains in effect until another EXTENDED 
ADDRESS RECORD | is encountered. The SBA defaults to zero until an 
EXTENDED ADDRESS RECORD is encountered. 


Recd Mark 
The RECD MARK field contains 03AH, the hex encoding of ASCII ‘:’. 


Rec Len 
The Record Length field contains 3032H, the hex encoding of ASCII ‘02’. 


Zeroes 
‘The Load Address field contains 30303030H, the hex encoding of ASCII ‘0000’. 


Rec Typ 
The Record Type field contains 3032H, the hex encoding of ASCII ‘02’. 


USBA 


The USBA field contains four ASCII hexadecimal digits that specify the 8086 USBA 
value. The high-order digit is the 10th character of the record. The low order digit is 
the 13th character of the record. 


Chk Sum 
This is the check sum on the REC LEN, ZEROES, REC TYP, and USBA fields. 


eee 
CHK 
DATA SUM 
eee 


The DATA RECORD provides a set of hexadecimal digits that represent the ASCII 
code for data bytes that make up a portion of an 8086 memory image. The method 
for calculating the absolute address for each byte of DATA is described in the 
discussion of the Extended Address Record. 


Data Record 


REC LOAD REC 
LEN ADDRESS TYP 


Recd Mark 
The RECD MARK field contains 03AH, the hex encoding of ASCII ‘:’. 


Rec Len 


The REC LEN field contains two ASCII hexadecimal digits representing the number 
of data bytes in the record. The high-order digit comes first. The maximum value is 
‘FF’ or 4646H (255 decimal). 
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Load Address 


The LOAD ADDRESS field contains four ASCII hexadecimal digits representing 
the offset from the SBA (see EXTENDED ADDRESS RECORD) defining the 
address at which byte 0 of the DATA is to be placed. The LOAD ADDRESS value is 
used in calculation of the address of all DATA bytes. 


Rec Typ 


The REC TYP field in a DATA record contains 3030H, the hex encoding of 
ASCII ‘00’. 


Data 


The DATA field contains a pair of hexadecimal digits that represent the ASCII code 
for each data byte. The high order digit is the first digit of each pair. 


Chk Sum 


This is the check sum on the REC LEN, LOAD ADDRESS, REC TYPE, and 
DATA fields. 


Start Address Record 


REC REC CHK 
LEN ZEROES TYP CS SUM 
‘04’ ‘0000’ ‘03’ 


The START ADDRESS RECORD is used to specify the execution start address for 
the object file. Values are given for both the Instruction Pointer (IP) and Code Seg- 
ment (CS) registers. This record can appear anywhere in a hexadecimal object file. 


If a START ADDRESS RECORD is not present in an 8086 hexadecimal file, a 
loader is free to assign a default start address. 


Recd Mark 
The RECD MARK field contains 03AH, the hex encoding for ASCII ‘:’. 


Rec Len 
The REC LEN field contains 3034H, the hex encoding for ASCII ‘04’. 


Zeroes 
The ZEROES field contains 30303030H, the hex encoding for ASCII ‘0000’. 


Rec Typ 
The REC TYP field contains 3033H, the hex encoding for ASCII ‘03’. 
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CS 


The CS field contains four ASCII hexadecimal digits that specify the 8086 CS value. 
The high-order digit is the 10th character of the record; the low-order digit is the 
13th character of the record. 


IP 


The IP field contains the four ASCII hexadecimal! digits that specify the 8086 IP 
value. The high-order digit is the 14th character of the record, the low order digit is 
the 17th character of the record. 


Chk Sum 
This is the check sum on the REC LEN, ZEROES, REC TYP, CS, and IP fields. 


End of File Record 


REC REC 


LEN ZEROES TYP 
0000’ 


*00’ ‘01’ 


The END OF FILE RECORD specifies the end of the hexadecimal object file. 


Recd Mark 
The RECD MARK field contains 03AH, the ASCII code for colon (:). 


Rec Len 
The REC LEN field contains two ASCII zeroes (3030H). 


Zeroes 
The ZEROES field contains four ASCII zeroes (30303030H). 


Rec Typ 
The REC TYP field contains 3031H, the ASCII code for 01H. 


Chk Sum 


The CHK SUM field contains 4646H, the ASCII code for FFH, which is the check 
sum on the REC LEN, ZEROES and REC TYP fields. 
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Examples 
Sample Absolute Object File 


The following is an example of an absolute object file. The file contains eight 
records. The eight records perform the following functions: 


Record Function 

1 LHEADR record begins the object module and defines the module 
name. 

2 THEADR record defines the translator-generated module name 
which is the same as the name in the LHEADR record. 

3 PEDATA record defines a contiguous memory image from 00200H 
to 00215H. 

4 PEDATA record defines a contiguous memory image from 00360H 
to 00377H. 

5 PEDATA record defines a contiguous memory image from 00415H 
to 0042BH. 

6 PEDATA record defines a contiguous memory image from 
051620H to 051633H. 

7 PIDATA record defines a contiguous memory image from 


051BO0H to 051B1DH. The iterated data consists of three repeti- 
tions of ‘‘ABC’”’ (414243H), followed by three repetitions of (four 
repetitions of ‘‘D’’ (44H)), three repetitions of ‘‘E’’ (45H). 


8 MODEND record specifies that the module should be started with 
CS = 5162H and IP = 0005H. 


(1) 82 0008 0653414D504C45 AE 

(2) 80 0008 0653414D504C45 BO 

(3) 84 001A 0020 00 
004992DB246DB6FF489 1 DA236CBSFE47 
90D9226BB4FD 63 

(4) 84 001C 0036 00 
0062C42688EA4CAE1072D43698FASCBE 
2082E446A80A6CCE 82 

(5) 84 001B 0041 05 
001D3A577491 AECBE805223F5C7996B3 
DOEDOA2744617E 72 

(6) 84 0018 5162 00 
00850A8F 14991EA328AD32B73CC146CB 
SODS5S5ADF FB 

(7) 86 001C 51B0 00 
0003 0000 03 414243 
0003 0002 
0004 0000 01 44 
0003 0000 01 45 FA 

(8) 8A 0006 CO 5162 0005 F8 


NOTE 


The blank characters and carriage return and line feed characters are 
inserted -here to improve readability. They do not occur in an object 
module. This file has been converted to ASCII hex so that it may be printed 
here. All word values (RECORD LENGTH, REPEAT COUNT, etc.) have 
been byte-reversed to improve readability. 
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Sample Absolute Hexadecimal Object File 


The following is the hexadecimal object file representation of the object file given in 
the example above: 


:020000020020DC 

:10000000004992DB246DB6FF489 1 DA236CBSFE47B8 
:0600100090D9226BB4FD43 

:020000020036C6 
:100000000062C42688EA4CAE1072D43698FASCBE00 
:080010002082E446A80A6CCE30 

:020000020041BB 

:1000050000 1D3A57749 1 AECBE805223F5C7996B353 
:07001500D0ED0A2744617ED3 

:020000025 16249 

:1000000000850A8F 14991 EA328AD32B73CC146CB98 
:04001000S50DS55ADF8E 

:0200000251BOFB 

7100000004 1424341424341424344444444454545BF 
:0E001000444444444545454444444445454524 
7040000035 162000541 

:00000001 FF 
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HEXADECIMAL-DECIMAL CONVERSION 


The following table is for hexadecimal-to-decimal and decimal-to-hexadecimal con- 
version. To find the decimal equivalent of a hexadecimal number, locate the hexa- 
decimal number in the correct position and note the decimal equivalent. Add the 
decimal numbers. 


To find the hexadecimal equivalent of a decimal number, locate the next lower 
decimal number in the table and note the hexadecimal number and its position. Sub- 
tract the decimal number from the table from the starting number. Find the dif- 
ference in the table. Continue this process until there is no difference. 


HEX DEC |HEX DEC | HEX DEC | HEX DEC | HEXDEC 


0 0 0 
1,048,576 65,536 4,096 
2,097,152 131,072 8,192 
3,145,728 196,608 12,288 
4,194,304 262,144 16,384 
5,242,880 327,680 20,480 
6,291,456 393,216 24,576 
7,340,032 458,752 28,672 
8,388,608 524,288 32,768 
9,437,184 589,824 36,864 

10,485, 760 655,360 40,960 
11,534,336 720,896 45,056 
12,582,912 786,432 49,152 
13,631,488 851,968 53,248 
14,680,064 917,504 57,344 
15,728,640 983,040 61,440 
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APPENDIX C 
THE EFFECT OF AVAILABLE MEMORY 
ON LINK86, CREF86, LIB86, AND LOC86 


The system resources required by LINK86, CREF86, LIB86, or LOC86 depend on 
the number of symbols, modules, or segments in the input file(s). The greater the 
number of symbols in the input, the greater the memory requirements. 


LINK86, CREF86, AND LIB8&6 


These utilities can take advantage of up to 512K of available memory space. When 
the number of symbols in the input list requires more memory than is available, 
these utilities use disk resources to accommodate the remainder. Available memory 
means RAM which the utilities have available to them exclusively. Once a utility has 
run out of memory and has to use disk, performance will become impaired. 


The following table defines the number of symbols or modules which these utilities 
may process without performance degradation, given several levels of available 
memory. The available memory depends on the hardware and software environment 
under which the utilities are running on your system. Note that the relationship 
between number of symbols or modules and the amount of available memory is 
linear, up to a maximum. The following assumptions were used to calculate the 
figures provided: 


¢ Variable and module names average 10 characters. 

e Each symbol has five references (CREF86). 

e Each module has 1.4 public names (LIB86). 

e A symbol as used here is an abstract representation of an 8086 object module 


format record: 
LINK86 CREF86 LIB86 

Maximum number of symbois or 

modules which can be processed 

without performance penalty: 

With 100K available memory 1,700 symbols 1,900 symbols 450 modules 
With 164K available memory 2,900 symbols 3,300 symbols 1,000 modules 
With 228K available memory 4,200 symbols 4,700symbols 1,700 modules 
With 484K available memory 10,000 symbois 11,000symbols 4,000 modules 
Theoretical maximum number of 

symbols or modules, regardless of 

available memory: 10,000 symbols 11,000symbois 4,000 symbols 


LOC86 


With 96K of available memory, LOC86 will support up to 900 segments. 


Table D-1 lists all of LINK86’s control syntax, abbreviations, and default settings. 


Table D-1. Summary of LINK86 Controls 


a o_o ae ae 
ASSIGN({ variable(address) }|,.. Not applicable 


ASSUMEROOT (pathname) a] Not applicable 


a 


MEMPOOL(min-size[,maxsize}) =a Not applicable 
NAME(module name) PNA | 


OBJECTCONTROLS( 
{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(symbo! [,...])] | 
NOPUBLICS [EXCEPT(symbo! [,...])] | 
TYPE | NOTYPE | ‘ 

PURGE | NOPURGE} [....]) 


Not applicable 


ORDER({group({segment{\class[\ overlay }]} 
[,--.])+ 


OVERLAY |(overiay)| NOOVERLAY 


NOOVERLAY NOOV 
a 


PRINTCONTROLS( 
{LINES | NOLINES | 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS [EXCEPT(symbol [,...])] | 
NOPUBLICS [EXCEPT(symbol [,...])] | 
TYPE | NOTYPE | 
PURGE | NOPURGE} |....]) 


Not applicable 


PRINT(object file.MP1) 


Not applicable 
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Table D-1. Summary of LINK86 Controls (Cont’d.) 


a 


SEGSIZE( 
{segment[\class[\overlay]] 
aes {max- size}}) } 


SYMBOLS SYMBOLS 
NOSYMBOLS 
SYMBOLCOLUMNS({1 | 2|3] 43) SYMBOLCOLUMNS(2) 


TYPE 
-NOTYPE NOTY 


The following are descriptions of all LINK86 error and warning messages. The 
description of each message has up to four parts: 


NOPURGE 


Not applicable 


Not applicable 


e Meaning—how to interpret the message 

e Cause—the usual reason for the error or warning condition 

e Effect—the state of LINK86 and the object file(s) after the message is issued 
e User Action—what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid. 


Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 


ERROR 1: I/0 ERROR 
operating systém error message 
FILE: pathname 


ERROR 2: 1/0 ERROR 
operating system error message 
FILE: pathname 
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ERROR 3: 1/0 ERROR 
operating system error message 
FILE: pathname 


ERROR 4: CONSOLE I/0 ERROR 
operating system error message 
FILE: pathname 

Meaning 


An I/O error was detected by the operating system. The error number identifies the 
file that caused the error: 


1. The input file 

2. The print file 

3. The object file 

4. Theconsole file (usually the console) 


Refer to the documentation for your operating system for a complete list of all 
possible messages. 


Effect 


LINK 86 immediately terminates processing, all open files are closed. The contents 
of the print and object files are undefined. 


User Action 
Correct the error and restart LINK86. 


ERROR 5: INPUT PHASE ERROR 
FILE: pathname 
MODULE: module name 


Meaning 


LINK86 encountered a record during the second phase of linkage that does not agree 
with information gathered during the first phase of linkage. 


Cause 


This error is caused by a data transmission error or a LINK86 error. 


Effect 


LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 


User Action 


Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 
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ERROR 6: CHECK SUM ERROR 
FILE: pathname 
MODULE: module name 
Meaning 
The check sum field at the end of one of the object module records indicates a 
transcription error. 
Cause 


Any one of many possible data encoding or communication errors could be at fault. 


Effect 


LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 


User Action 
Retranslate the source that produced the specified module and relink. 


ERROR 7: COMMAND INPUT ERROR 

Meaning 

LINK86 encountered an error while attempting to read the complete invocation line. 
Cause 

Possibly an end-of-file while reading from the console input device. 


Effect 


LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 


User Action 
Examine the invocation line, and reinvoke LINK86 correctly. 
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WARNING 8: SEGMENT COMBINATION ERROR 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
CLASS: class name 


Meaning 


Two segments with the same name have been found to be uncombinable. 


Cause 


The specified segments have different combination attributes or incompatible align- 
ment attributes. 


Effect 


Although LINK86 will continue processing pass 1, pass 2 will not be started. The 
object file will be useless and the print file will contain limited information. 


User Action 


Retranslate the source that produced the specified file and module. 


WARNING 9: TYPE MISMATCH 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 


Meaning 


LINK86 has found a public/external symbol pair for which the type definitions do 
not agree. 


Effect 


LINK86 continues processing using the first definition only. The object file and the 
print file should be valid, except the second definition is ignored. 


User Action 


Modify the public or external declaration and recompile and relink the source file. 
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WARNING 10: DIFFERENT VALUES FOR 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 
Meaning 
LINK86 encountered the same symbol declared public in two different modules. The 
specified file and module contains the second definition encountered. 
Cause 
Two modules have used the same symbol name for different public definitions. 


Effect 

LINK86 continues processing using the value of the first public definition; the 
second definition is ignored. Both the print file and the object file will be valid. 
User Action 


Change the name of the symbol in either the specified file or the file containing the 
earlier definition. 


ERROR 11: INSUFFICIENT MEMORY 
FILE: pathname 
MODULE: module name 
Meaning | 
There is insufficient memory in your system for LINK86 to build its internal tables 
and data structures. 
Cause 


You are using too many public symbols. 


Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 

User Action 


If expanding system memory is not possible, try incremental linkage (i.e., link 
smaller sets of files together using the NOPUBLICS control, then link the resulting 
composite modules together). 


iAPX 86,88 Family Utilities LINK86 Controls and Error Messages 


WARNING 12: UNRESOLVED SYMBOLS 
FILE: pathname 
MODULE: module name 


Meaning 


There are declarations of external symbols that were not resolved during this 
linkage. 


Cause 


This is very common when performing an incremental linkage. 


Effect 


The print file is valid. The object file must be linked to resolve the external 
references. 


User Action 


Link object file to a file that will resolve the external references. 


WARNING 13: IMPROPER FIXUP 
FILE: pathname 
MODULE: module name 


Cause 


The external reference makes assumptions about the segment register that do not 
agree with the assumption made for the public definition. 


Effect 


LINK86 continues processing. The object file will not be usable, but the print file 
will be complete and accurate. 


User Action 


Depending on the cause of the error: change yourORDER control, recompile with a 
different model of segmentation, or change the source and reassemble. 
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WARNING 14: GROUP ENLARGED 
FILE: pathname 
GROUP: group name 
MODULE: module name 
Meaning 


The specified group name has been defined twice in two different modules. The 
segments contained in the two definitions are different. 


Effect 


The two groups are combined into one. All segments that were in either group are 
included in the resulting group. Segments with the same segment name, class name, 
and overlay name are combined. LINK86 continues processing. Both the print file 
and object file are valid. 


User Action 


No user action should be necessary. 


ERROR 15: LINK86 ERROR 
FILE: pathname 
MODULE: module name 


User Action 


Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 


ERROR 16: STACK OVERFLOW 
FILE: pathname 
MODULE: module name 


Meaning 
LINK86’s run time stack used for type matching has overflowed. 


Cause 


The type definition of one of your symbols is overly complex. 


Effect 


LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 


‘User Action 


Try incremental linkage — if error persists, contact Intel. 
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WARNING 17: SEGMENT OVERFLOW 
SEGMENT: segment name 
CLASS: class name 


Meaning 


The combination of two or more segments has resulted in a segment that exceeds 
64K. 


Effect 


‘LINK86 continues processing during the current pass, but the print and object files 
are not useable. 


User Action 


Reorganize your segments and reassemble. 


WARNING 18: IMPROPER START ADDRESS 
FILE: pathname 
MODULE: module name 


Meaning 


A start address was found in one of the overlay modules, and none was found in the 
root module. 


Cause 


This error is often caused by misordering the input modules in the input list. 


Effect 

LINK86 ignores the start address in the specified overlay module and continues 
processing. 

User Action 


If you want the module containing the start address to be the root, relink with that 
module first in the input list. 


ERROR 19: TYPE DESCRIPTION TOO LONG 
FILE: pathname 
MODULE: module name 

Meaning 


The type definition is too long to fit in LINK86’s symbol table. 
Effect 


LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 


User Action 


Contact Intel immediately. Forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 


LINK86 Controls and Error Messages iAPX 86,88 Family Utilities 


WARNING 20: NO SUCH GROUP 
NAME: group name 


Cause 


You have attempted to rename a nonexistent group. 


Effect 
LINK86 ignores the RENAME control and continues processing. 


User Action 


Reinvoke LINK86 with the correct invocation line. 


WARNING 21: RENAME ERROR 
NAME: name 


Meaning 


The new group name specified is the same as an existing group. 


Effect 


The group is not renamed. LINK86 continues as if the rename control was not given. 


User Action 
Reinvoke LINK86 with the correct invocation line. 


ERROR 22: INVALID SYNTAX 
ERROR IN COMMAND TAIL NEAR # 
partial command tail 

Cause 


This is usually the result of a typo in the invocation line. The partial command tail. 
up to the point where the error was detected is printed. 


Effect 


LINK86 terminates processing and closes all open files. The contents of the print file 
and the object file are undefined. 


User Action 
Reinvoke LINK86 more carefully this time. 
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ERROR 23: BAD OBJECT FILE 
FILE: pathname 
MODULE: module name 


Meaning 

LINK86 has discovered an inconsistency in the fields of a record in the specified 
input file. 

Cause 


This could be an error by the translator or a data transmission error. 


Effect 


LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 


User Action 


Retranslate the source file. If the problem persists contact Intel. 


WARNING 24: CANNOT FIND MODULE 
FILE: pathname 
MODULE: module name 


Meaning 


The specified module cannot be found in the specified library file. 


Effect 


LINK86 continues processing as if the specified module was not in the list. 


User Action 


If the module is important, you can link it into the output object file later. 


WARNING 25: EXTRA START ADDRESS IGNORED 
FILE: pathname 
MODULE: module name 


Meaning 


LINK86 has encountered a start address in more than one module. 


Cause 


This will occur any time you specify more than one main module in the input list. 


Effect 


LINK86 uses the start address encountered earlier and ignores the start address in 
the specified module. LINK86 continues processing with no other side effects. 


User Action 


None, if the start address in the specified module was intended to be ignored. 
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ERROR 26: NOT AN OBJECT FILE 
FILE: pathname 

Meaning 

The specified file is not an object file. 


Cause 


This is usually the result of a typo when entering. However, certain data trans- 
mission errors can also cause this error. 


Effect 


LINK86 terminates processing and closes all open files. 


User Action 


Reinvoke LINK86 typing the line more carefully. If error resulted from a data 
transmission error, retranslate and then relink. 


ERROR 27: OPERATING SYSTEM INTERFACE ERROR 
FILE: pathname 
Effect 
LINK86 immediately terminates processing and closes all open files. The contents of 
the print file and the object file are undefined. 
User Action 


Refer to the documentation for your operating system. If you cannot correct the 
error condition, contact Intel; forward a copy of the object file, the LINK86 invoca- 
tion line, and your version of LINK86. 


WARNING 28: POSSIBLE OVERLAP 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
CLASS: classname 
Meaning 


LINK86 issues this warning when it combines two absolute segments. 


Effect 


LINK86 continues processing with no side effects. 


User Action 
If there is a conflict LOC86 or the loader will detect the overlap. 
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WARNING 29: GROUP HAS BAD EXTERNAL REFERENCE 
GROUP: groupname 
SEGMENT: segment name 

Meaning 


This error occurs if the public symbol corresponding to an external reference has 
been specified by its absolute address, and the address does not reside in any 
segment. 


Effect 

LINK86 continues processing and the print and object files will be valid except the 
external reference has not been properly resolved. 

User Action 


Either remove the reference to the public symbol! or do not allow the symbol to be 
absolute. 


ERROR 30: LIBRARY IS NOT ALLOWED WITH PUBLICSONLY CONTROL 
FILE: pathname 

Meaning 

The specified file is a library and libraries are not allowed in a PUBLICSONLY 

control. 

Effect 

LINK86 immediately terminates processing and closes all open files. The contents of 

the print file and the object file are undefined. 

User Action 

Remove library file from PUBLICSONLY argument list and reinvoke LINK86. 


WARNING 31: REFERENCED LOCATION OFFSET UNDERFLOW 
FILE: pathname 
MODULE: module name 
Meaning 
While computing the offset for an 8089 self relative reference, LINK86 had a 
negative result. 
Cause 


Either with the ORDER control or the order of files in the input list, the reference 
was separated from its target, or the 8089 segment is too large. 


Effect 


LINK86 continues processing; however, the invalid offset computation is used. 


User Action 


Examine the ORDER control in the invocation line and modify its arguments. 
Reinvoke LINK86 carefully. 
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WARNING 32: EXTRA REGISTER INITIALIZATION RECORD IGNORED 
FILE: pathname | 
MODULE: module name 

Cause 


You have included two main modules in your input list. 


Effect 

LINK86 uses the first register initialization record and ignores the second. Process- 
ing continues. 

User Action 


If the register initialization information in the specified file and module should be 
used, then modify your input list; otherwise, no user action is necessary. 


ERROR 33: ILLEGAL USE OF OVERLAY CONTROL 

FILE: pathname . 

MODULE: module name 
Meaning 
LINK86 has found an overlay definition in the specifed file and module, while pro- 
cessing input modules for an overlay. . 
Effect 
LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 
User Action 


Remove the specified file from the input list and relink. 


ERROR 34: TOO MANY OVERLAYS IN INPUT FILE 
FILE: pathname 
MODULE: module name 

Meaning 


The specified file and module above contains more than one overlay definition. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action. 


Remove the specified file from the input list and relink. 
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ERROR 35: SAME OVERLAY NAME IN TWO OVERLAYS 
FILE: pathname 
MODULE: module name 
NAME: name 


Meaning 


The specified file contains an overlay that has the same name as an overlay 
encountered in the input list. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Remove one of the duplicate names from the input list and relink. If both overlays 
are necessary, relink one overlay specifying a different overlay name. 


ERROR 36: ILLEGAL OVERLAY CONSTRUCTION 
FILE: pathname 
MODULE: module name 


Meaning 


Some of the modules in the input list contain overlay definitions while others do not. 
This is not permitted — all modules in the input list must be the same with respect to 
overlays. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Remove the non-overlay files and relink. 


WARNING 37: DIFFERENT PUBLICS FOR EXTERNAL IN ROOT 
FILE: pathname 
MODULE: module name 


Meaning 


LINK86 has found two symbol definitions in the overlay modules that resolve an 
external symbol definition in the root. 


Effect 


LINK86 ignores the definition in the specified file and module, and continues pro- 
cessing with no side effects. 


User Action 


Remove the unwanted symbol definition and relink. 


D-15 


LINK86 Controls and Error Messages iAPX 86,88 Family Utilities 


ERROR 38: INVALID OVERLAPPING GROUPS 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
GROUP: group name 
Meaning 
While binding the input list LINK86 found a segment that was defined to be within 
two groups. 
Effect 
LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 
User Action 


Either modify the source to remove the segment from one of the groups or do not 
link with the BIND control. 


ERROR 39: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 
GROUP: group name 


Cause 


Often this is the result of a typographical error in the invocation line. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Correct the invocation line and relink. 


ERROR 40: SPECIFIED SEGMENT NOT FOUND IN THE GROUP 
SEGMENT: segment name 
GROUP: group name 


Cause 
Usually this is the result of a typographical error in the ORDER control. 


Effect 


LINK86 immediately terminates processing;. all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Correct the invocation line and relink. 
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ERROR 41: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 
SEGMENT: segment name 
CLASS: classname 

Cause 


Usually this is the result of a typographical in the SEGSIZE control. 
Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Find the module that contains the specified segment and add it to the input list. 


WARNING 42: DECREASING SIZE OF SEGMENT 
SEGMENT: segment name 


Meaning 


The size change specified in SEGSIZE has caused LINK86 to decrease the size of the 
specified segment. 


Effect 


Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the memory allocation process. LINK86 continues processing with no side 
effects. 

User Action 


None if the size decrease was intended. 


ERROR 43: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 
SEGMENT: segment name 
CLASS: class name 

Meaning 


The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 


Effect 


LINK8&6 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 
Reinvoke LINK86 with the correct SEGSIZE control. 
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ERROR 44: SEGMENT SIZE UNDERFLOW; OLD SIZE + CHANGE < 0 
SEGMENT: segment name 
CLASS: classname 

Meaning 


The size change specified in the SEGSIZE control caused the segment’s size to be 
less than zero. 


Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Reinvoke LINK86 with the correct SEGSIZE control. 


ERROR 45: THE SEGMENT MAXIMUM SIZE IS LESS THAN THE 
SEGMENT MINIMUM SIZE 
SEGMENT: segment name 
CLASS: class name 
Cause 


Usually this is the result of a typographical error in the SEGSIZE control. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Correct the invocation line and relink. 


ERROR 46: ILLEGAL USE OF SEGSIZE CONTROL 
SEGMENT: segment name 
CLASS: classname 

Cause 


A maximum size was specified for either a stack segment, an absolute segment, or a 
segment that is not the highest component of its group. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Remove the specified segment from the SEGSIZE control and relink. 
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WARNING 47: GROUP HAS NO CONSTITUENT SEGMENTS 
GROUP: group name 


Meaning 


The group has no segments and is not placed in the output object file. 


Cause 


Often this is the result of a typographical error in the invocation line. 


Effect 

LINK86 does not place the specified group in the object file and continues process- 
ing with no side effects. 

User Action 


Unless there is some particular need for the specified group, no user action is 
necessary. 


WARNING 48: SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 
Meaning 


All of the segments that belong to the specified group do not fit within the physical 
segment defined for that group. 


Cause 
This error is usually caused by misuse of the SEGSIZE or ORDER controls. 


Effect 


LINK86 includes all segments in the object file and continues processing the input 
module. The output module will be executable, although addressing errors may 
occur. 


User Action 


Examine the invocation line and reinvoke LINK86 using the SEGSIZE or ORDER 
control more carefully. 
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WARNING 49: MAXIMUM SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 
Meaning 
The maximum segment size for the segments contained in the specified group 
exceeds 64K. 
Cause 
This error is usually caused by misuse of the SEGSIZE control. 


Effect 

LINK86 reduces the maximum size of the group and its constituent segments. 
LINK86 continues processing the input module. The output module will be 
executable. 

User Action 


No action is necessary. If you want to remove the error, examine the invocation line 
and reinvoke LINK86 using the SEGSIZE control more carefully. 


WARNING 50: MORE THAN ONE SEGMENT WITH THE MEMORY 
ATTRIBUTE 
SEGMENT: segment name 
Meaning 
After the first memory segment is found, LINK86 issues this warning each time it 
finds a segment with the memory attribute. 
Effect 


LINK86 ignores the memory attribute on the segment specified in the message. 
Processing continues with LINK86 treating the additional memory segment as just 
another segment. 

User Action 


Depending on your intentions, this message may be ignored or you may wish to 
change the segment definition and relink. 


WARNING 571: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 
HIGHEST IN MEMORY 
SEGMENT: segment name 
Meaning . 
The specified memory segment was not located at the highest offset in its group. 


Cause 


This can only occur when you explicitly request this organization through the 
ORDER control. 


Effect 


Since this can only occur by user request, LINK86 continues processing without side 
effects. 
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WARNING 52: OFFSET FIXUP OVERFLOW 
FILE: pathname 
MODULE: module name 


Meaning 


While computing an offset from a base, LINK86 found that the offset was greater 
than 64K. 


Cause 


One of the segments of a group is outside the 64K frame of reference defined by its 
group base. 


Effect 


LINK86 continues processing. The print file will be valid, but the output file with 
regard to the out of place segment will not be usable. 


User Action 


Modify the group definitions in your source and retranslate. 


WARNING 53: OVERFLOW OF LOW BYTE FIXUP VALUE 
FILE: pathname 
MODULE: module name 


Meaning 


An 8-bit displacement value, when calculated, exceeded 255. 


Cause 


This type of error often occurs when a page resident segment crosses a page 
boundary. 


Effect 


LINK86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 


User Action 


Organize your segments so that the addressing error will not be encountered. 


ERROR 54: ILLEGAL USE OF ORDER CONTROL 
GROUP: group name 


Meaning 


The specified group’s segments have already been ordered. 


Cause 
You are attempting to relink a file that has been linked with the BIND control. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 


Relink using the unbound input modules. 
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ERROR 55: ILLEGAL FIXUP 
FILE: pathname 
MODULE: module name 
Meaning 
While processing a fixup record, LINK86 found that the base for the reference and 
target are different. 
Cause 


This is usually a coding error. 


Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 


Examine your assembly language source and retranslate. 


ERROR 56: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 
Meaning 
One of the data records associated with the specified segment contains an address 
outside of the segment’s boundary. 
Cause 


This error can occur when you decrease the size of a segment. 


Effect 

LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 

User Action 

Change SEGSIZE control and relink. 


ERROR 57: MAXIMUM DYNAMIC STORAGE LESS THAN MINIMUM 
DYNAMIC STORAGE 
Meaning 


The size change specified in MEMPOOL has caused the maximum dynamic storage 
to be less than the minimum dynamic storage. 


Effect 


LINK86 immediately terminates processing; all open files are closed. The contents 
of the print and object files are undefined. 


User Action 
Reinvoke LINK86 with correct arguments to MEMPOOL. 
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WARNING 58: NO START ADDRESS SPECIFIED IN INPUT MODULES 


Meaning 


The BIND control was specified, and none of the input modules has a start address. 


Cause 


The input list contains no main module. 


Effect 


The CS and IP registers remain uninitialized, and their values are dependent on your 
system loader. The object module will be valid. 


User Action 
Reinvoke LINK86 with a main module or execute LOC86 with the START control. 


ERROR 59: 1/0 ERROR WITH ROOT-FILE IN ASSUMEROOT CONTROL 
FILE: pathname 
operating system message 


Meaning 


The ASSUMEROOT control was specified, but the root file identified by pathname 
in the invocation could not be accessed. 


Effect 


LINK86 immediately terminates processing. 


User Action 


Refer to your operating system documentation to correct the condition, then rein- 
voke LINK86. 


ERROR 60: OUTPUT FILE IS SAME AS INPUT FILE 
FILE: pathname 


Meaning 


LINK86 detected an output pathname identical to an input pathname. 


Cause 


The pathnames of the specified input file and the output file were identical. 


Effect 


LINK86 terminates processing immediately. 


User Action 


Reinvoke LINK86 after fixing the duplicate-name situation. 
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ERROR 61: ROOT-FILE IN ASSUMEROOT CONTROL IS NOT PROPER 
OBJECT FILE 
FILE: pathname 
Meaning 
The ASSUMEROOT control was specified, but the root file is not found to have an 
overlay record in it. 
Cause 


The root file needs an overlay record. 


Effect 


LINK86 terminates processing immediately. 


User Action 
Relink the root file using the OVERLAY control. 


WARNING 62: ASSUMEROOT CONTROL MEANINGFUL ONLY WITH 
OVERLAYS 

Meaning 

The ASSUMEROOT control should be used only when the input modules do not 

contain overlay records. 

Cause 

ASSUMEROOT was specified, but not in conjunction with the OVERLAY control. 


Effect 
LINK86 ignores the ASSUMEROOT control. The object code is valid. 


User Action 
Reinvoke LINK86, using the OVERLAY and ASSUMEROOT controls. 


WARNING 63: BAD SEGMENT ALIGNMENT 
FILE: pathname 
MODULE: module name 
SEGMENT: segment name 


Meaning 
The segment is not paragraph/page-aligned. 


Cause 


The object code has references to the base of the specified segment, and the segment 
is not declared as paragraph/page-aligned. 


Effect 


Although the object module will be valid, the loader may not load the program 
correctly. 


User Action 
Declare the specified segment to be paragraph/page-aligned. 
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WARNING 64: PUBLIC SYMBOLS NOT SORTED DUE TO INSUFFICIENT 
MEMORY 


Meaning 


The amount of memory required to sort the public symbols for the LINK86 print file 
listing is insufficient. 


Cause 


The number of public symbols in the input-list modules is too large for LINK86 to 
sort with the available memory resources. 


Effect 


The LINK86 print file listing provides public symbols in the order in which they were 
encountered in the input files. This condition has no effect on the correctness or 
validity of the output module. 


User Action 


Increase the amount of available RAM or decrease the number of public symbols. 


WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 
EXTERNAL SYMBOL 
FILE: pathname containing external declaration 
MODULE: name of module containing external declaration 
SYMBOL: name of external symbol 
FRAME: identification of reference location 
TARGET: identification of target location 


Meaning 


The declaration of the specified SYMBOL was found to be inconsistent with a 
corresponding public symbol definition, and LINK86 could not resolve the 
reference. 


Cause 


This condition may exist for several reasons. The modules containing the external 
and public symbols may have been compiled under different translator controls 
(e.g., SMALL, LARGE). In the case of assembly language programs, the SYMBOL 
may be defined in a group, segment, or frame different from that in which it is 
declared as external. Or an attempt has been made to access absolute entry points 
from pre-located code without using the PUBLICSONLY control explicitly. 


Effect 


LINK86 internally converts these illegal fixups to legal formats to. identify all 
occurrences in a single execution. Thus the output object module may not be cor- 
rect, although it will be a valid 8086 object module. 


User Action 


If the warning occurred because of an attempted access of absolute entry points 
from pre-located code, use the PUBLICSONLY control in conjunction with the file 
that contains public definitions for those entry points. Otherwise, use the FRAME 
and TARGET information given in the warning message to pinpoint the source of 
the error, then correct the code. 
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For example: 


WARNING 65: ILLEGAL FIXUP: INCORRECT DECLARATION OF 
EXTERNAL SYMBOL 
FILE: EXTFIL 
MODULE: EXTMODULE 
SYMBOL: EXTSYM 
FRAME: GROUP - GROUP1 
TARGET: SEGMENT - SEGMENTS 


The symbol EXTSYM is declared to be in SEGMENTS. The external-public resolu- 
tion specified that the calculations be made with respect to the base of GROUP I, 
but the segment SEGMENTS is not in GROUP. 


WARNING 66: CS AND IP REGISTERS ARE NOT INITIALIZED 


Meaning 


The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. CS means code segment 
register, and IP means instruction pointer. 

Cause 


This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 


Effect 


The values of CS and IP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 


User Action 
Retranslate your code, then reinvoke LINK86. 


WARNING 67: SS AND SP REGISTERS ARE NOT INITIALIZED 


Meaning 


The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of 8086 registers. SS means stack segment and 
SP means stack pointer. 

Cause 


This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 


Effect 


The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. The object code will be valid. 


User Action 
Correct your code if necessary, then reinvoke LINK86. 
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WARNING 68: DS REGISTER NOT INITIALIZED 


Meaning 


The INITCODE control was specified, and the register initialization record does not 
contain information for initialization of the 8086 DS (data segment) register. 


Cause 


This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 


Effect 


The value of the DS register at program execution is entirely dependent on the loader 
of your system. 


User Action 


Correct your code if necessary, then reinvoke LINK86. 


WARNING 69: OVERLAPPING DATA RECORDS 


Meaning 


The FASTLOAD control was specified, and two data records belonging to the same 
segment have offsets which make them overlapping. 


Cause 


This warning is usually the result of a translation error, unless you have intentionally 
overlapped data records. 


Effect 


LINK86 ignores the second record and does not include it in the output file. The 
code will be unusable. 


User Action 


If you want an overlap condition to exist, reinvoke, but do not use the FASTLOAD 
control. Otherwise, retranslate, then reinvoke LINK86. 


WARNING 70: INITCODE CONTROL INEFFECTIVE WITH BIND 
CONTROL 


Meaning 


The INITCODE and BIND controls were combined in One invocation statement. 


Effect 
The INITCODE control will be ignored by LINK86. 


User Action 


Do not invoke LINK86 using both of these controls at the same time. To invoke 
them separately, use the INITCODE control first, then the BIND control during a 
second invocation. 
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WARNING 71: TOO MANY MAIN MODULES IN INPUT 
FILE: pathname 
MODULE: module name 
Meaning 
LINK86 discovered two or more main modules (modules with start addresses) in the 
input list. 
Cause 


The input list contains too many main modules. 


Effect 

LINK86 uses the start address of the first main module it reads and ignores the 
others. The object code will be valid. 

User Action 


Ensure that the LINK86 interpretation is suitable to your objectives. If not, modify 
the input list, and reinvoke LINK86. 


WARNING 72: REGISTER INITIALIZATION CODE EXISTS, NEW 
INITIALIZATION IGNORED 
FILE: pathname 
MODULE: module name 
Meaning 
Two or more initialization codes for 8086 registers were encountered in the input 
list. 
Cause 


This condition resulted from a translation or linkage problem. 


Effect 


LINK86 uses the first initialization code and ignores the others. The object code will 
be valid. 


User Action 


If retranslating or relinking does not correct the error, contact Intel. 


WARNING 73:2 INITCODE CONTROL INEFFECTIVE WITH OVERLAYS 


Meaning 
Both INITCODE and OVERLAY controls were specified. 


Effect 
The INITCODE control is ignored. The object code will be valid. 


User Action 


Reinvoke LINK86, using the INITCODE control. In a second invocation, specify 
the OVERLAY control. 
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ERROR 74: PRINT FILE SAME AS INPUT FILE 
FILE: pathname 


Meaning 
The pathnames of the print file and one of the input files are identical. 


Effect 


LINK86 terminates processing immediately. 


User Action 
Reinvoke LINK86 after fixing the duplicate-name situation. 


ERROR 75: PRINT FILE SAME AS OUTPUT FILE 


Meaning 


The names of the print and output files are identical. 


Cause 


The invocation line included duplicate names. 


Effect 
LINK86 terminates processing immediately. 


User Action 


Correct the invocation line and reinvoke LINK86. 


WARNING 76: BASE OF REFERENCED SEGMENT DIFFERS FROM BASE 
OF CONTAINING GROUP 
FILE: pathname 
GROUP: group name 
MODULE: module name 
SEGMENT: segment name 


Meaning 


An assembly language reference to the base of the specified segment in the specified 
group exists. However, the specified segment is not the first segment in the group. 
This warning occurs only when BIND is in effect. 


Cause 


Unless you have deliberately created this reference, this warning is most likely the 
result of an incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 


Effect 

LINK86 will process the specified reference to the segment base rather than to the 
group base. The output module will be valid. 

User Action 


If the reference to the segment base was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then 
reassemble and relink. 
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WARNING 77: REFERENCED OFFSET IN SEGMENT DIFFERS FROM 
OFFSET FROM GROUP BASE | 
FILE: pathname 
GROUP: groupname 
MODULE: module name 
SEGMENT: segment name 


Meaning 


An assembly language reference to an offset from the base of the specified segment 
in the specified group exists. However, the specified segment is not the first segment 
in the group. This warning occurs only when BIND is in effect. 


Cause 


Unless you have deliberately created this reference, this warning is most likely the 
result of an-incorrect ASSUME directive or an incorrect OFFSET operator 
specification. 


Effect 

LINK86 will process the specified reference as an offset from the segment base 
rather than the group base. The output module will be valid. 

User Action 


If the reference to the offset in the segment was deliberate, continue debugging your 
assembly language code as planned. Otherwise, check the correctness of the code, 
particularly the ASSUME directives and OFFSET operator specifications; then’ 
reassemble and relink. 


D-30 


APPENDIX E 


CREF86 CONTROLS| 


AND ERROR MESSAGES 


Table E-1 lists all of CREF86’s control syntax, abbreviations, and default settings. 


Table E-1. Summary of CREF86 Controls 


ae at 
PAGELENGTH(number) PAGELENGTH(60) 
PAGEWIDTH(number) = as PAGEWIDTH(120) 


PRINT (pathname) PRINT (first input file .CRF) 
TITLE(character-string) Not applicable 


The following are descriptions of all CREF86 error and warning messages. The 
description of each message has up to four parts: 


e Meaning—how to interpret the message 

e Cause—the usual reason for the error or warning condition 

e Effect—the state of CREF86 and the object file(s) after the message is issued 
e User Action—what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error messages are always fatal, but warning messages are not. 


Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 


ERROR 1: 1/0 ERROR 
operating system message explaining the cause of this erorr 
FILE: pathname 


Meaning 


An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 


Effect 


CREF86 immediately terminates processing; all open files are closed. The contents 
of the print file are undefined. 


User Action 
Correct the error and restart CREF86. 
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ERROR 2: SYNTAX ERROR IN INPUT COMMAND 


Meaning 


An error in the syntax of the invocation line was detected. 


Cause 


This condition is usually the result of a typographical error or transposition. 


Effect 


The invocation command line, to the point it is parsed, is written to the console with 
a # following this string. 


User Action 


Correct the syntactic error and retransmit the invocation line(s). 


ERROR 3: QUT OF MEMORY 


Meaning 


CREF86 does not have enough memory to create its internal data structures, tables, 
etc. This condition may also occur because of inadequate disk space for temporary 
files. 


Cause 


The input list contains too many symbols and/or too many references among them. 


Effect 


CREF86 immediately terminates processing, closing all open files. The contents of 
the print file are undefined. 


User Action 


Ensure that adequate resources are available to run CREF86. 


ERROR 4: 1/0 ERROR 
operating system error message 
FILE: pathname 

Meaning 


An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 


Effect 
CREF86 processing is immediately terminated. 


User Action 
Correct the error and restart CREF86. 
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ERROR 5: IMPROPER OBJECT MODULE 
FILE: pathname 
MODULE: module name 


Meaning 
The specified module does not meet 8086 object module requirements. 


Cause 


This condition may be caused by the translator or by an error in data transmission. 


Effect 


CREF86 processing is immediately terminated. 


User Action 


Try retranslating the source file. If the problem persists, call Intel. 


ERROR 6: PREMATURE EOF 
FILE: pathname 


Meaning 


CREF86 expects more input data, but encounters an end-of-file (EOF) condition. 


Cause 


This condition usually results from a translator error. 


Effect 


CREF86 processing is immediately terminated. 


User Action 


Return to the previous step in program development, then retranslate or relink. 


ERROR 7: LIBRARY SEEK ERROR 
FILE: pathname 
MODULE: module name 


Meaning 


CREF86 did not encounter a proper library record when scanning a library file. 


Cause 
The library file or the disk may be corrupted. 


Effect 


CREF86 immediately terminates processing. 


User Action 
Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 8: LIBRARY IN OVERLAY MODE 
FILE: pathname 
Meaning 
An input list contains object file(s) with an overlay record count greater than zero 
and a library file. 
Cause 


Libraries cannot contain overlay records. CREF86 can process either all modules or 
no modules with overlay records. 


Effect 


CREF86 immediately terminates processing. 


User Action 
Reinvoke CREF86 using a valid input list. 


ERROR 9: IMPROPER MODULE SEQUENCE 
FILE: pathname 
MODULE: module name 


Meaning 


A combination of modules containing overlay records with those containing 
nonoverlay records was encountered in the input list. 


Cause 


CREF86 can process input lists consisting of either all modules with overlay records 
or no modules with overlay records. 


Effect 


CREF86 immediately terminates processing. 


User Action 
Reinvoke CREF86 with a valid input list. 
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ERROR 10: MORE THAN 255 OVERLAYS NOT SUPPORTED 


Meaning 


The input list contains over 255 files with overlay records. 


Cause 


CREF86 does not support more than 255 overlay files. In the case of input lists 
without overlays, however, there is no limit (except available memory) on the 
number of files CREF86 can process. 


Effect 


CREF86 immediately terminates processing. 


User Action 
Reinvoke CREF86 using fewer than 255 overlay files. 


ERROR 11: TOO MANY OVERLAYS 
FILE: pathname 
MODULE: module name 


Meaning 
The input file contains more than one overlay. 


Cause 


CREF86 can support files with only one overlay record each. 


Effect 


CREF86 terminates processing immediately. 


User Action 


Reinvoke CREF86 with an input list containing files with no more than one overlay 
each. 
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ERROR 12: 1/0 ERROR 
operating system error message 
FILE: pathname 


Meaning 


An I/O error was detected. See the appropriate operating system documentation for 
interpretation. 


Effect - 
CREF86 terminates processing immediately. 


User Action 
Correct the error and restart CREF86. 


ERROR 13: IMPROPER PAGE WIDTH SPECIFICATION 


Meaning 


The PAGEWIDTH control specification includes a number outside the valid 
syntactic range. 


Effect 
CREF86 terminates processing immediately. 


User Action 


Correct the syntax error and reinvoke CREF86. CREF86 accepts a PAGEWIDTH 
number in decimal form from 80 to 132, inclusive, in the following format: 


PAGEWIDTH (number) 
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ERROR 14: IMPROPER PAGE LENGTH SPECIFICATION 


Meaning 


The PAGELENGTH control specification includes a number outside the valid 
syntactic range. 


Effect 


CREF86 terminates processing immediately. 


User Action 


Reinvoke CREF86 using the proper PAGELENGTH syntax. CREF86 accepts a 
PAGELENGTH number in decimal form from 10 through 255, in the following 
format: 


PAGELENGTH (number) 


ERROR 15: ILLEGAL LIBRARY FILE 
FILE: pathname 


Meaning 


CREF86 did not encounter a proper library record in the proper location. 


Cause 
The library file or disk may be corrupted. 


Effect 


CREF86 terminates processing immediately. 


‘User Action 
Reinvoke CREF86 after replacing the file or the disk. 
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ERROR 16: IMPROPER OBJECT FILE 
FILE: pathname 
MODULE: module name 


Meaning 


iAPX 86,88 Family Utilities 


CREF86 did not encounter an 8086 object module record in the proper location. 


Cause 


The object file may be corrupt or the file may not be an 8086 object file. 


Effect 


CREF86 terminates processing immediately. 


User Action 


Determine whether the integrity of the object file is intact and whether the file is a 
proper input file for CREF86. Reinvoke CREF86 with a valid and usable object file. 


ERROR 17: OUTPUT FILE SAME AS INPUT FILE 
FILE: pathname 
MODULE: module name 


Meaning 


CREF86 detected an output pathname identical to an input pathname. 


Cause 


The invocation line specified two identical pathnames. 


Effect 


CREF86 terminates processing immediately. 


User Action 


Reinvoke CREF86 after fixing the duplicate-name situation. 
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ERROR 18: CREF86 INTERNAL ERROR 
FILE: pathname 
MODULE: module name 


User Action 


Contact Intel immediately. Forward a copy of the object file, the CREF86 invoca- 
tion line, and your version of CREF86. 


WARNING 19: TYPE MISMATCH 
FILE: pathname 
MODULE: module name 
SYMBOL: symbol name 


Meaning 
CREF86 detected a type mismatch between two symbols with the same name. 


Cause 


Two symbols are declared to have identical names but different types, and the 
symbols are not in different overlay modules. 


CREF86 does not check the entire TYPE declaration for any given symbol. For 
example, dimension values for arrays, number of parameters in procedure calls, etc. 
are not compared. Only simple types (e.g., byte, word, structure) are checked. 


Effect 


CREF86 flags the condition in the cross-reference listing. 


User Action 


Ensure that the condition is not damaging to your programming objectives. 
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WARNING 20: SPECIFIED MODULE NOT FOUND 
FILE: pathname 
MODULE: module name 


Meaning 


A module explicitly included in the input list of the invocation is not found by 
CREF86. 


Cause 
The specified module is not part of the file specified by the pathname. 


Effect 
CREF86 continues processing the modules it is able to find. 


User Action 
Determine why the module is missing, then reinvoke CREF86. 


ERROR 21: OPERATING SYSTEM INTERFACE ERROR 
operating system error message 


Meaning 
CREF86 cannot open its temporary file. 


Effect 


CREF86 terminates processing immediately. 


User Action 


Refer to the documentation on the operating system to help diagnose any possible 
operating system malfunction. 
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The table below shows all of LIB86’s commands. 


Table F-1. Summary of LIB86 Commands 


ee 


ADD {pathname|[(module name{,...})]} Adds modules to a library 
[,...] TO pathname 
CREATE pathname Creates a library file 


A 
DELETE pathname(module name {,...]) Deletes modules from a library 
file 
EXIT poe | Terminates session with LIB86 
L 
[P] 


LIST {pathname|(module name {,...])] Lists modules contained ina 
[,---] [TO pathname] [PUBLICS] library file, and optionally lists 

The following are descriptions of all LIB86 error and warning messages. The 

description of each message has up to four parts: 


all publics 


e Meaning—how to interpret the message 

e Cause—the usual reason for the error or warning condition 

e Effect—the state of LIB86 and the object file(s) after the message is issued 
¢ User Action—what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error and warning messages are displayed at the console device. 


MODULE NOT FOUND 
MODULE: module name 
FILE: pathname 


Meaning 
The specified module could not be found in the specified library. 
Cause 
There is a typographical error in the command line. 
Effect 
- LIB86 ignores the module in the list and continues processing. 


User Action 


No user action is necessary. 
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RIGHT PARENTHESIS EXPECTED 
partial command tail 


LEFT PARENTHESIS EXPECTED 
partial command tail 


INVALID MODULE NAME 
partial command tail 


WODULE NAME TOO LONG 
partial command tail 


INVALID SYNTAX 


partial command tail 


'TO' EXPECTED 
partial command tail 


Meaning 
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All of the above errors are syntax errors. For each of the above errors LIB86 issues 
the associated error message and displays the partial command up to the point of the 


error. 


Cause 


There is a typographical error in the command line. 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 


and issues the prompt character (*). 


User Action 


Examine the command line, make the necessary corrections and reissue the 


command. 
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UNRECOGNIZED COMMAND 


Cause 
You mistyped a command (ADD, CREATE, DELETE, EXIT, or LIST). 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 


User Action 


Examine the command line and enter the corrected command. 


INSUFFICIENT MEMORY 


Meaning 


There is not enough memory available to execute the command. 


Cause 


Exceptionally long and complex commands can cause this error. 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 


User Action 


Simplify your command line and reexecute. 


COMMAND LINE TOO LONG 
partial command tail 


Meaning 


The length of the LIB86 command you tried to execute exceeded the size limit of the 
system’s command buffer. 


Effect 


LIB86 immediately terminates processing the command, displays this error message 
plus the portion of the command it would accept, then issues the prompt character 


(*). 
User Action 


Simplify your command line and reexecute. 
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LIB86 ERROR 


Meaning 


LIB86 failed an internal consistency check. 


Effect 

LIB86 immediately terminates processing. The results of previous commands on the 
library being manipulated when this error occurred may have been lost. 

User Action 


Contact Intel. Forward a copy of the libraries and object files used during the 
session in which the error occurred. 


FILE ALREADY EXISTS 

FILE: pathname 

Meaning 

The file specified in the CREATE command already exists. 


Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Specify a nonexistent file in the CREATE command. 


DUPLICATE SYMBOL IN INPUT 

SYMBOL: symbol name 

MODULE: module name 

FILE: pathname 

Meaning 

The specified public symbol conflicts with a public symbol defined in one of the files 
given earlier in the input list. This error occurs only during the ADD command. 


Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). The library being manipulated returns to the 
state it was in prior to the ADD command that prompted this message. 

User Action 


Correct the ADD command and reinvoke LIB86. 
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NOT A LIBRARY 
FILE: pathname 


Cause | 
The file that the command requests LIB86 to DELETE or LIST is not a library file. 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 


User Action 


Reissue the command specifying a library file. 


ILLEGAL RECORD FORMAT 
MODULE: module name 
FILE: pathname 


Cause 


This error is usually caused by a transcription error or translation error in some part 
of an object file examined by LIB86. 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 


User Action 


Return to the last step in program development, then retranslate, relink, or relocate. 


PREMATURE EOF 
MODULE: module name 
FILE: pathname 


Meaning 


Due to some transcription error or other the specified file has no module end record. 


Cause 


This is usually the result of a transcription error or translator error. 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 


User Action 


Return to the last step in. program development, then restranslate, relink, or 
relocate. 
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CHECKSUM ERROR 
MODULE: module name 
FILE: pathname 
Meaning 


The specified file has an error in one of its checksum fields. 


Cause 


This is the result of a transcription error. 


Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 


User Action 


Return to the last step in program development, then retranslate, relink, or relocate. 


ATTEMPT TO ADD DUPLICATE MODULE 

MODULE: module name 

Meaning | 

A module with the specified module name already exists in the library. 


Effect 

LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 

Remove the duplicate module from the list and reissue the command. 


ATTEMPT TO ADD MODULE CONTAINING OVERLAYS 
MODULE: module name 

FILE: pathname 

Effect 


LIB86 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). All modules in the input list up to the erroneous 
file are added to library. 

User Action 


Reissue the command with all elements in the input list except those that contain 
overlays. 
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PUBLIC SYMBOL ALREADY IN LIBRARY 
SYMBOL: symbol name 

MODULE: input module name 

FILE: input pathname 

Meaning 


The library already contains the public symbol identified in the error message. 


Cause 

This error occurs when a module is added that has a symbol definition already in the 
library. 

Effect 

LIB8&6 immediately terminates processing the command, displays the error message, 
and issues the prompt character (*). 

User Action 


Reexecute the command without the file that contains the duplicate symbol. 


APPENDIX G 
LOC86 CONTROLS 


AND ERROR MESSAGES 


Table G-1 lists all of LOC86’s control syntax, abbreviations, and default settings. 


Table G-1. Summary of LOC86 Controls 


ADDRESSES( Not applicable 
{SEGMENTS({segment|\class|[\overlay]] 
(addr)}[,...]) | 
CLASSES({class(addr)}[,...] | 
GROUPS({group(addr)}[,...]) + 
[,---]) 


BOOTSTRAP Not applicable 


COMMENTS COMMENTS 


LINES 
NOLINES 


MAP 


NOMAP 


NAME(module name) ; 


OBJECTCONTROLS( 
{LINES | NOLINES | Not applicable 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE?} {,...]) 


ORDER( Not applicable 
{SEGMENTS({segment|\class[\overlay]]} 


CLASSES({class[(segment [,...])]} [,...])} 
[,---]) 


PRINT[(pathname)]| PRIN T(objectfile.MP2) 


NOPRINT 


PRINTCONTROLS( 
{LINES | NOLINES | Not applicable 
COMMENTS | NOCOMMENTS | 
SYMBOLS | NOSYMBOLS | 
PUBLICS | NOPUBLICS | 
PURGE | NOPURGE} |....]) 


PUBLICS PL PUBLICS 
NOPUBLICS | 
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Table G-1. Summary of LOC86 Controls (Cont’d.) 


Se 
RESERVE( {addr TO addr? [,...}) | ns | Not applicable 


SEGSIZE({segment{ \class| \overlay]} 


(size)}([,...]) fo 
roommate SSCSC*dSCU 


SYMBOLCOLUMNS({1}2]3] 43) 


The following are descriptions of all LOC86 error and warning messages. The 
description of each message has up to four parts: 


e Meaning—how to interpret the message 

¢ Cause—the usual reason for the error or warning condition 

e Effect—the state of LOC86 and the object file(s) after the message is issued 
e User Action—what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the code 
is valid. 


Error and warning messages are displayed at the console device, but printed only if a 
listing would otherwise be printed. 


ERROR 1: 1/0 ERROR: 
operating system error message 


Meaning 


An I/O error was detected. Refer to the documentation for your operating system 
for interpretation. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 


_the print and object files are undefined. 


User Action 
Correct the error and restart LOC86. 
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ERROR 2: INVALID SYNTAX 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 


Meaning 


A syntax error was detected in the invocation line. LOC86 repeats the invocation 
line up to the point of the error. 


Cause 


This is usually the result of a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Reenter the invocation line more carefully. 


ERROR 3: MISSING INPUT FILE NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command fail 


Meaning 


LOC86 was unable to find the input file name in the invocation. LOC86 repeats the 
invocation line up to the point of the error. 


Cause 


This is usually the result of a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Reinvoke LOC86 more carefully. 
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ERROR 4: INSUFFICIENT MEMORY 


Meaning 


The memory available on your system has been used up by LOC86. 


Cause 


This can be caused by an input module that has a very large number of segments or 
an impossibly long invocation line. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


This may require changing the source file to reduce the number of segments and 
retranslating. 


ERROR 5: BAD RECORD FORMAT 
MODULE: module name 


Meaning 


There is a record in the specified input module that has an incorrect format. 


Cause 


This is usually a transcription error. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


‘Retranslate and relink the input files before attempting to locate the input module 
again. 
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ERROR 6: INVALID KEY WORD 
ERROR IN COMMAND TAIL NEAR. #: 
partial command tail 


Meaning 


One of the controls or subcontrols in the invocation line is incorrect. LOC86 repeats 
the invocation line up to the point of the error. 


Cause 


This is usually the result of a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Reinvoke LOC86 more correctly. 


ERROR 7: NUMERIC CONSTANT LARGER THAN 20 BITS 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 
Meaning 
You have specified an address greater than 1,048,575 (OFFFFFH). LOC86 repeats 
the invocation line up to the point of the error. 
Effect 
LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 
User Action 


Examine the invocation line and invoke LOC86 with the correct address. 


ERROR 8: NON NUMERIC CHARACTER IN NUMERIC CONSTANT 
ERROR IN COMMAND TAIL NEAR @: 
partial command tail 


Meaning 


This is a type of syntax error. LOC86 repeats the invocation line up to the point of 
the error. 


Cause 


This is usually caused by a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Enter the invocation more carefully. 
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ERROR 9: NUMERIC CONSTANT LARGER THAN 16 BITS 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 
Meaning 
You have specified an offset greater than 65,536 (OFFFFH). LOC86 repeats the 
invocation line up to the point of the error. 
Effect 
LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 
User Action 


Retype the invocation line more carefully. 


ERROR 10: INVALID SEGMENT NAME 

ERROR IN COMMAND TAIL NEAR #: 

partial command tail 
Meaning 
LOC86 was expecting a segment name when it found a token that does not cor- 
respond to a valid segment name. LOC86 repeats the invocation line up to the point 
of the error. 
Cause 


This is usually the result of a typographical error. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Reinvoke LOC86 more carefully. 
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ERROR 11: INVALID CLASS NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail 


Meaning 


LOC86 was expecting a class name when it found a token that does not correspond 
to a valid class name. LOC86 repeats the invocation line up to the point of the error. 


Cause 


This is usually the result of a typographical error. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Reinvoke LOC86 more carefully. 


ERROR 12: INVALID INPUT MODULE 
MODULE: module name 


Meaning 


The input module is invalid. It could mean that object module records are out of 
order, or LOC86 has found an invalid field within a record, or a required record is 
missing. 

Cause 


This is usually caused by a translator error or an attempt to locate something other 
than an object file (e.g., a source file). 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Retranslate source and relink, then try to locate again. If this error continues contact 
Intel. 
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WARNING 13: MORE THAN ONE SEGMENT WITH THE MEMORY 
ATTRIBUTE 
SEGMENT: segment name 
Meaning 


After the first memory segment is found, LOC86 issues this warning each time it 
finds a segment with the memory attribute. 


Effect 


LOC86 ignores the memory attribute on the segment specified in the message. Pro- 
cessing continues with LOC86 treating the additional memory segment as just 
another segment. 


User Action 


Depending on your intentions, this message may be ignored or you may wish to 
change the attribute for the segments and relink them. 


WARNING 14: GROUP DEFINED BY AN EXTERNAL REFERENCE 
NAME: external name 
GROUP: group name 


Meaning 


The specified group is defined by an external reference. This is a type of unresolved 
external reference. 


Effect 


LOC86 continues processing without side effects. 


User Action 


Find the module that defines the specified symbol and relink the input module. 


WARNING 15: PUBLIC SYMBOL NOT ADDRESSABLE 
NAME: public symbol name 
Meaning 


The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the public symbol is not completely contained within the 64K 
physical segment defined by the symbol’s base. 

Effect 


LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified public symbol will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 

User Action 


Change the ORDER or ADDRESSES control so that the segment containing the 
public symbol will be within range of the symbol’s base. 
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WARNING 16: LOCAL SYMBOL NOT ADDRESSABLE 
NAME: /ocal symbol name 
Meaning 


The specified symbol is more than 64K from its base. This error occurs when the seg- 
ment containing the local symbol is not completely contained within the 64K 
physical segment defined by the symbol’s base. 


Effect 


LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified symbol will not produce the desired results. Debug 
symbols with this attribute will not be added to the object file. 

User Action 


Change the ORDER or ADDRESSES control so that the segment containing the 
local symbol will be within range of the symbol’s base. 


WARNING 17: LINE NUMBER NOT ADDRESSABLE 
NAME: /ine number 
Meaning 


The specified line is more than 64K from its base. This error occurs when the seg- 
ment containing the line number is not completely contained within the 64K physical 
segment defined by the line’s base. 


Effect 


LOC86 continues processing. The object file will be executable. However, any 
attempt to access the specified line number will not produce the desired results. 
Debug symbols with this attribute will not be added to the object file. 


User Action 


Change the ORDER or ADDRESSES control so that the segment containing the line 
number will be within range of the line’s base. 
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WARNING 18: SIZE OF GROUP EXCEEDS 64K 
GROUP: group name 
Meaning 
Some of the segments of the specified group are not contained within the physical 
segment defined by the group’s base. 
Cause 
This error is usually caused by misuse of the ORDER or ADDRESSES control. 


Effect 


LOC86 continues processing the input module. The output module will be 
executable, but addressing errors may result. 


User Action 


Examine the invocation line and reinvoke LOC86 using the ORDER or 
ADDRESSES control more carefully. 


WARNING 19: BOOTSTRAP SPECIFIED FOR MODULE WITHOUT START 


ADDRESS 
Meaning 
You have specified BOOTSTRAP when locating a module that has no start address. 
Effect 


LOC86 continues processing as if no BOOTSTRAP control was specified. 


User Action 


If you wish initialization code in the program, relocate the input module specifying 
both BOOTSTRAP and START. 


ERROR 20: INVALID NAME 
NAME: bad name 
Cause 


This is the result of a typographical error in the NAME control. A valid name is 
composed of up to forty of the following characters in any order: 


e Alphabetic (A, B, C, ..., Z) 
e Numeric (0, 1, 2, ..., 9) 
e Special (@, ?,:, ., _) 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Reinvoke LOC86 more carefully. 
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ERROR 21: SEGMENT REGISTER DEFINED BY SPECIFIED EXTERNAL 
NAME 
NAME: externalname 
Meaning 


A segment register or register pair is defined using the specified external symbol 
name. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Relink and relocate your object modules. 


ERROR 22: SEGMENT SIZE OVERFLOW; OLD SIZE + CHANGE > 64K 
SEGMENT: segment name 
CLASS: classname 

Meaning 


The size change specified in the SEGSIZE control caused the segment to become 
greater than 64K. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


Look at the segment’s size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 


ERROR 23: SEGMENT SIZE UNDERFLOW; OLD SIZE - CHANGE < 0 
SEGMENT: segment name 
CLASS: class name 

Meaning 


The size change specified in the SEGSIZE control caused the segment’s size to be 
less than zero. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Look at the segment’s size in the link map and reinvoke LOC86 with the correct 
SEGSIZE control. 
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ERROR 24: INVALID ADDRESS RANGE 


Meaning 
The arguments to the RESERVE control are invalid. 


Cause 
The usual cause of this error is that the low address is larger than the high address. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 25: PUBLIC SYMBOL NOT FOUND 
NAME: public symbol name 
Meaning | 
The symbol specified in the START control was not found. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


Either specify the argument to START with paragraph and offset, or specify an 
éxisting public symbol. 


WARNING 26: DECREASING SIZE OF SEGMENT 
SEGMENT: segment name 
Meaning 
The size change specified in SEGSIZE has caused LOC86 to decrease the size of the 
specified segment. 
Effect 


Decreasing the size of a segment can cause sections of code to be unaccounted for 
during the locating process. This is only a warning message. LOC86 continues pro- 
cessing with no side effects. 


User Action 


If the size decrease was not intended, examine the SEGSIZE control in the invoca- 
tion line and relocate. 
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ERROR 27: SPECIFIED SEGMENT IS ABSOLUTE 
SEGMENT: segment name 


Meaning 


You attempted to assign an address to an absolute segment. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Reinvoke LOC86 without using absolute segments in the ADDRESSES control. 


WARNING 28: PAGE RESIDENT SEGMENT CROSSES PAGE BOUNDARY 
SEGMENT: segment name 
Cause 


If you have changed the specified segment’s size, it may be too large to fit within a 
256 byte page, or if you have specifed an address for the segment, it may force the 
segment to cross a page boundary. 


Effect 


Since this error can only occur when you have intentionally specified the segment in 
a control, LOC86 ignores the page resident attribute and continues to process the 
module as if no error has occurred. 


User Action 


If you have invoked LOC86 correctly, then the message is only verifying your inten- 
tions — no action is necessary. 
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WARNING 29: OFFSET FIXUP OVERFLOW 

MODULE: module name , 

REFERENCED LOCATION: 20-bit address 

FRAME OF REFERENCE: 20-bit address 
Meaning 
While computing an offset from a base (FRAME OF REFERENCE), LOC86 found 
that the REFERENCED LOCATION was more than 64K bytes away from the base. 
Cause 
This error usually occurs as a result of misuse of the ORDER or ADDRESSES 
control. One of the segments of a group is outside the 64K byte physical segment 
defined by its group base. 
Effect 
LOC86 continues processing. The print file will be valid, but the output file with 
regard to the out-of-place segment will not be usable. 
User Action 


Find the symbol that corresponds to the referenced location, and change the 
ORDER or ADDRESSES control. 


WARNING 30: UNRESOLVED EXTERNAL REFERENCE TO NAME 
AT SPECIFIED ADDRESS 

NAME: symbol name 

SEGMENT: segment name 

ADDRESS: 20-bitaddress 
Meaning 
There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 
Cause 


You are locating a module that is not completely linked. 


Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 


No action is necessary if the unresolved reference is known. Otherwise, you must 
relink and resolve the external reference. 
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WARNING 31: UNRESOLVED EXTERNAL REFERENCE TO NAME NEAR 
SPECIFIED ADDRESS 
NAME: symbol name 
SEGMENT: segment name 
ADDRESS: 20-bit address 
Meaning 
There is no public definition for the specified public symbol. There is an unresolved 
external reference to that symbol in the specified segment. 
Cause 


You are locating a module that has not been completely linked. 


Effect 

LOC86 continues processing with no side effects. The print file will be valid, and 
except for the unresolved references the object file should be executable. 

User Action 


No action is necessary if the unresolved reference is known. Otherwise, you must 
relink to resolve the external reference. 


WARNING 32: OVERFLOW OF LOW BYTE FIXUP VALUE 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 

Meaning 


An 8-bit displacement value, when calculated, exceeded 255. 


Cause 


This type of error often occurs when a page resident segment crosses a page 
boundary. 


Effect 

LOC86 continues processing. The contents of both the print file and the object file 
will be valid. However, the fixup value will remain invalid. 

User Action 


Find the symbol that corresponds to the REFERENCED LOCATION and organize 
your segments so that the addressing error will not be encountered. 
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WARNING 33: GROUP HAS NO CONSTITUENT SEGMENTS 
GROUP: group name 


Meaning 


The group has no segments and is not placed in the output object file. 


Cause 


Often this is the result of a typographical error in the invocation line. However, it 
may be a linking error that has not shown up until now. 


Effect 


LOC86 continues processing with no side effects. 


User Action 


Unless there is some particular need for the specified group, no user action is 
necessary. 


ERROR 34: SPECIFIED CLASS NOT FOUND IN INPUT MODULE 
CLASS: classname 
Effect 
LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 
User Action 


Find the module that contains the specified class and link it into the module to be 
located. 


ERROR 35: SPECIFIED SEGMENT NOT FOUND IN INPUT MODULE 
SEGMENT: segment name 
CLASS: classname 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


Find the module that contains the specified segment and link it into the module to be 
located. 
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WARNING 36: SEGMENTS OVERLAP 
SEGMENT: segmentname 
SEGMENT: segment name 
LOW OVERLAP ADDRESS: 20-bit address 
HIGH OVERLAP ADDRESS: 20-bit address 
Meaning 


The two segments overlap in the specified address range. 


Cause 


This can be caused by any number of things: mistake in the SEGSIZE control, 
misuse of ADDRESSES, or two absolute segments that overlap. 


Effect 

LOC86 continues processing the input module. The print file is valid, and the object 
file, with the exception of the overlap, should be usable. 

User Action 


If overlap was intended, no action is necessary. Otherwise, depending on the cause 
of the message, it may be necessary to relocate or even modify the source, and 
retranslate, relink, and relocate. 


ERROR 37: INPUT MODULE EXCEEDS 8086 MEMORY 
SEGMENT: segment name 
Meaning 
While attempting to locate the specified segment, LOC86 ran out of available 8086 
address space. 
Cause 


Although it is possible to write a program that uses a full megabyte of memory, this 
error usually results from an error in the arguments to the RESERVE control. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the RESERVE control. If, in fact, your program requires more than 
1,048,576 bytes of memory, try optimizing with ASM86 or use overlays. 
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WARNING 38: SEGMENT WITH MEMORY ATTRIBUTE NOT PLACED 
HIGHEST IN MEMORY 
SEGMENT: segment name 
Meaning 


The specified memory segment was not located at the highest address in memory. 


Cause 


This can only occur when you explicitly request this organization through the 
ORDER or ADDRESSES control, or when you implicitly request it by assigning 
another segment to the top of memory. 


Effect 


Since this can only occur by user request, LOC86 continues processing without side 
effects. 


ERROR 39: NO MEMORY BELOW SEGMENT FOR SPECIFIED SEGMENT 
SEGMENT: segmentname . 
SEGMENT: segmentname 
Meaning 
In the ORDER control you have requested that the first segment be located below 
the second segment. LOC86 found that there is not enough memory to maintain this 
order. 
Cause 


This error can only occur when one of the segments in an ORDER control is 
absolute. The absolute segment is not necessarily either of the segments specified in 
the command. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Modify the order control. 
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WARNING 40: CANNOT MAINTAIN SPECIFIED ORDERING 
SEGMENT: segmentname 

Meaning 

LOC86 cannot locate all of the segments in the ORDER control consecutively. 


Cause 


This is usually caused by specifying absolute segments in the ORDER control or by 
specifying the same segments in ORDER and ADDRESSES. The conflict might not 
be immediately obvious. For example, the specified segment may be specified in the 
ORDER control by its segment name and specified in the ADDRESSES control by 
its class name. 

Effect 

LOC86 continues processing. The print and object files are valid. However, the 
requested segment ordering is not maintained. 

User Action 


Carefully examine your invocation line to find the conflict and relocate the input 
module. 


ERROR 41: SPECIFIED CLASS OUT OF ORDER 
CLASS: classname . 
Meaning 
The ORDER control and ADDRESSES control for the specified class disagree. 


Cause 


Either you have assigned an address to the specified class or one of its constituent 
segments, or the translator has made one of its constituent segments absolute. In 
either case, the ORDER control cannot be realized. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Modify the ADDRESSES control or modify the ORDER control. 
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ERROR 42: SPECIFIED SEGMENT OUT OF ORDER 
SEGMENT: segment name 
Meaning 
The ORDER control and ADDRESSES control for the specified segment disagree. 


Cause 


Either you have assigned an address to the specified segment or the translator has 
made the segment absolute. In either case, the ORDER control cannot be realized. 


Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 

Modify the ADDRESSES control or modify the ORDER control. 


ERROR 43: ADDRESS FOR CLASS SPECIFIED MORE THAN ONCE 
CLASS: class name 

Cause 

This is often caused by a typographical error or some other mechanical error while 

entering the invocation line. 

Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 

the print and object files are undefined. 

User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 44: SEGMENT ADDRESS PREVIOUSLY SPECIFIED IN INPUT 
MODULE OR COMMAND LINE 
SEGMENT: segment name 
CLASS: classname 
Cause 
Either the specified segment is absolute or it has been listed twice in the same 
ADDRESSES control. 
Effect | 
LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 
User Action 


Examine the invocation line. If the translator has made it an absolute segment, 
either use the translator-assigned address or retranslate the segment. 
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ERROR 45: SEGMENT SPECIFIED MORE THAN ONCE IN ORDER 
SEGMENT: segment name 
CLASS: classname 

Cause 


This error can be caused by either of two errors in the invocation line. You have 
simply specified the same segment twice in the ORDER control. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line and ORDER control and reinvoke LOC86. 


ERROR 46: CLASS SPECIFIED MORE THAN ONCE IN ORDER 
CLASS: class name 


Cause 


You have specified the same class more than once in the same ORDER control. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 47: SPECIFIED SEGMENT NOT IN SPECIFIED CLASS 
SEGMENT: segment name 
CLASS: class name 


Cause 


This error is usually caused by a typographical error in the arguments to an ORDER 
control. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line and reinvoke LOC86 correctly. 
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ERROR 48: INVALID COMMAND LINE 


Meaning 

LOC86 has encountered an end-of-file or an I/O error while reading the invocation 
line. 

Cause 

You probably terminated the invocation line in the middle of a control argument. 
Most likely you forgot to type the ampersand before you typed the carriage return. 
Effect 

LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 

User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


WARNING 49: SEGMENT ALIGNMENT NOT COMPATIBLE WITH 
ASSIGNED ADDRESS 

SEGMENT: segment name 
Meaning 
The alignment attribute does not agree with the address specified in the 
ADDRESSES control. 
Effect 
LOC86 ignores the address assignment and treats the segment as any other 
relocatable segment. 
User Action 


If the address that LOC86 assigns is satisfactory, then no action is necessary. Other- 
wise, examine the print file and assign an address that will agree with the alignment 
attribute. 
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ERROR 50: INVALID COMMAND LINE; TOKEN TOO LONG 
ERROR IN COMMAND LINE NEAR #: 
partial command tail 
Meaning 


An invocation line ‘‘token’’ is impossibly long. A token is a series of characters that 
are not broken by a parenthesis, a comma or a blank (space, carriage-return, line- 
feed or tab). Tokens are syntactic units used in invocation line parsing. Depending 
on how it is used, a token can be a control word, a symbol name, a segment name, a 
filename, etc. 

Cause 


This is often the result of a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


WARNING 51: REFERENCING LOCATION IS OUTSIDE 64K FRAME OF 
REFERENCE 
MODULE: module name 
ADDRESS: 20-bit address 
FRAME OF REFERENCE: 20-bitaddress . 
Meaning 


The address of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the self- 
relative instruction. 


Cause 
This error occurs as a result of misuse of the ORDER or ADDRESSES control. 


Effect 


LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 


User Action 


Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 
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WARNING 52: REFERENCED LOCATION OUTSIDE 64K FRAME OF 
REFERENCE 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bit address 
Meaning 


The target of a self-relative reference lies outside of the 64K frame of reference of 
the jump or call. This error occurs while locating the module containing the target of 
a self-relative instruction. 

Cause 


This error occurs as a result of misuse of the ORDER or ADDRESSES control. 


Effect 

LOC86 continues processing. The print file is valid, but the object file with respect 
to the module containing the self-relative reference is not executable. 

User Action 


Examine the locate map and reinvoke LOC86 modifying your ORDER and 
ADDRESSES control to correct the error. 


WARNING 53: CANNOT ALLOCATE CLASS AT SPECIFIED ADDRESS 
ADDRESS: 20-bit address 
CLASS: classname 

Meaning 


The specified class cannot be located at the address requested. This is the result of a 
conflict with another address assignment, or an absolute segment, or an address less 
than 200H. 


Effect 


LOC86 assigns the class to the nearest address that will not cause conflict. LOC86 
continues processing, and both the print and object file are valid. 


User Action 


If the alternate address suits your purpose, then no action is necessary. Otherwise, 
examine the locate map and modify your invocation line. 
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ERROR 54: DATA ADDRESS OUTSIDE SEGMENT BOUNDARIES 
SEGMENT: segment name 
MODULE: module name 
Meaning 
One of the data records associated with the specified segment contains an address 
outside of the segment’s boundary. 
Cause 


This error can occur when you assign an address or an order to an absolute segment, 
or a size to a segment. Under some circumstances this can be the result of a linkage 
or translation error. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 
Change the ADDRESSES, ORDER, or SEGSIZE control and relocate. 


WARNING 55: UNDEFINABLE SYMBOL ADDRESS 
SEGMENT: segment name 
MODULE: module name 


Meaning 


A local symbol, line number, or public symbol has been found in the specified seg- 
ment that is addressed relative to the specified group’s base address. However, the 
segment containing the symbol is not within the 64K frame of reference that is 
defined for that group. 


Cause 


This is usually the result of an address assignment error in the invocation line. 


Effect 


LOC86 continues processing with no other side effects. The print file and object files 
are valid. However, you cannot use the symbols contained in the specified segment. 


User Action 


Examine the invocation line and reinvoke LOC86. 
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WARNING 56: SEGMENT IN RESERVE SPACE 
SEGMENT: segment name 


Cause 


Either an absolute segment uses the area reserved in the invocation line or you 
assigned an address to a segment or class that forces the specified segment to be 
located in the reserved area. 


Effect 


The specified segment is located in the reserved area, and LOC86 continues process- 
ing with no other side effects. Both the print file and object file are usable. 


User Action 


If the assigned address is acceptable for the segment, no action is necessary. 


ERROR 57: INVALID GROUP NAME 
ERROR IN COMMAND TAIL NEAR #: 
partial command tail. 


Meaning 


LOC86 was expecting a group name when it found a token that did not correspond 
to a valid group name. LOC86 repeats the invocation line up to the point of the 
error. 


Cause 


This is often caused by a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 58: SPECIFIED GROUP NOT FOUND IN INPUT MODULE 
GROUP: groupname 


Cause 


This is often caused by a typographical error in the invocation line. 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line to LOC86 and the link map for the input module. 
Reinvoke LOC86 correctly. 
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ERROR 59: GROUP ADDRESS PREVIOUSLY SPECIFIED IN INPUT 
MODULE OR COMMAND LINE 
GROUP: groupname | 
Cause 


Either you gave a single group an address twice in the same ADDRESSES control or 
the group already had an address (due to a previous locate). 


Effect 


LOC86 immediately terminates processing; all open files are closed. The contents of 
the print and object files are undefined. 


User Action 


Examine the invocation line and either use the previously assigned address or assign 
the group one address per ADDRESSES control. 


WARNING 60: REFERENCED LOCATION IS NOT WITHIN 32K OF 
SPECIFIED ADDRESS 
MODULE: module name 
REFERENCED LOCATION: 20-bit address 
FRAME OF REFERENCE: 20-bitaddress 


Meaning 


An 8089 self-relative reference is not within 32K bytes of its target address. 


Cause 


‘Either with the ORDER or ADDRESSES control you have separated the reference 
from its target or the 8089 segment is too large. 


Effect 


LOC86 leaves the invalid reference and continues processing with no other side 
effects. Both the print file and the object file will be valid. 


User Action 


Examine the invocation line and reinvoke LOC86 correctly. 


ERROR 61: OVERLAY ERROR 


Meaning 


An internal LOC86 error has occurred. 


User Action 


Contact Intel immediately. 
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WARNING 62: CS AND IP REGISTERS NOT INITIALIZED 


Meaning 

This warning occurs when INITCODE is specified and the input register initializa- 
tion record does not specify intialization of the 8086 code segment (CS) register and 
the 8086 instruction pointer (IP) register. 

Cause 


This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 


Effect 


The values of CS and IP at the beginning of program execution are completely 
dependent on the loader of your system. 


User Action 
Invoke LOC86 with the START control if desired. 


WARNING 63: SS AND SP REGISTERS NOT INITIALIZED 


Meaning 


The INITCODE control was specified, but the register initialization record does not 
contain information for initialization of stack segment (SS) and stack pointer (SP) 
records. 


Cause 


This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 


Effect 


The values of SS and SP at the beginning of program execution are entirely depen- 
dent on the loader of your system. 


User Action 


If you will need to use the stack, retranslate your code, then relink and relocate. 
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WARNING 64: DS REGISTER NOT INITIALIZED 


Meaning 

INITCODE was specified, but the data segment (DS) register initialization record is 
incomplete. 

Cause 


This condition is usually the result of an incomplete END directive in your assembly 
language module or a translation error. 


Effect 

The value of the CS register at program execution is entirely dependent on the 
system loader. 

User Action 

Correct your code if necessary, then reinvoke LINK86 and LOC86. 


WARNING 65: SEGMENT ORDER IN ORDER-CONTROL CANNOT BE 
MAINTAINED 
SEGMENT: segment name 
Meaning 


The ADDRESSES and ORDER control specifications for a segment are in conflict 
and/or the segment cannot be allocated space in accordance with the ORDER 
control. 


Effect 


The conflicting segment is allocated space after all other segments in the target 8086 
memory. 


User Action 


If desired, reinvoke LOC86, using the appropriate ADDRESSES and ORDER 
controls. 
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WARNING 66: START ADDRESS NOT SPECIFIED IN OUTPUT MODULE 


Meaning 


The CS (code segment) and IP (instruction pointer) registers are not initialized. 


Cause 

The input module does not have an explicit start address, and the START control 
was not specified. 

Effect 

The values of these registers upon initial program execution are entirely dependent 
on the loader. 

User Action 


Either reinvoke LOC86 using the START control or relink to include a main 
module. 
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OH86 ERROR MESSAGES 


The following are descriptions of all OH86 error and warning messages. The 
description of each message has up to four parts: 


¢ Meaning—how to interpret the message 

e Cause—the usual reason for the error or warning condition 

e Effect—the state of OH86 and the object file(s) after the message is issued 
e User Action—what you can do to correct the condition 


Not all these parts are given for each message. However, parts excluded are self- 
explanatory. 


Error messages are always fatal, but warning messages are not. In the event of a 
warning, read the EFFECT of the warning carefully to determine whether the 
resulting code is valid. 


Error and warning messages are displayed at the console device. 


pathname, PREMATURE END-OF-FILE ENCOUNTERED 


Meaning 


OH86 has scanned the entire input file without finding the record that signals the 
end of the module. 


Cause 


There is a transcription error in the specified file. 


Effect 


OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 


User Action 


Return to the last step in the program development process that did not generate this 
error and relocate, relink, or even retranslate. 
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pathname, EXPECTED MODULE HEADER NOT FOUND 
Meaning 
The first record in the input file was not a module header record. 


Cause 


This is usually caused by specifying an input file that does not contain an 8086 object 
module. 


Effect 


OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 


User Action 


Check the invocation line; if you specified the input file incorrectly, then reinvoke 
OH86 more carefully. Otherwise, return to the last step in the program development 
process and reexecute. 


pathname, ILLEGAL RELOCATION RECORD ENCOUNTERED 


Cause 


This error occurs whenever you specify a non-absolute 8086 object module as the 
input file. 


Effect 


OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 


User Action 
Locate the object module with LOC86 before reinvoking OH86. 


pathname, INSUFFICIENT MEMORY TO PROCESS DATA RECORD 


Meaning 


There is insufficient memory in your system for OH86 to process your input file. 


Cause 


You are trying to convert a file that is too complex for the available memory in your 
system. 


Effect 


OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 


User Action 


Expand the memory on your system. 
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pathname, ILLEGAL REGISTER INITIALIZATION RECORD ENCOUNTERED 


Cause 
Your input module contains a register initialization record. 
Effect 


OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 


User Action 
Relocate with INITCODE in effect. 


pathname, ILLEGAL OVERLAY INFORMATION ENCOUNTERED 


Cause 


You attempted to convert a file containing overlay information. 


Effect 


OH86 immediately terminates processing and closes all open files. The contents of 
the output file are undefined. 


User Action 


If overlays are necessary, create root and overlay in separate files. 


APPENDIX | 
ADDITIONAL INFORMATION 
FOR INTELLEC® SERIES Ill USERS 


Environmental Considerations 


The iAPX 86,88 Family utilities run on and can be used to produce code executable 
on the Intellec Series III Microcomputer Development System. Resulting code is also 
compatible with the ICE-86 Emulator and DEBUG-86. 


‘The following conventions of the Series III operating system (ISIS-II) are 
encountered in running the utilities: 


e The utilities must be executed when the Series III is in the 8086 mode. This 
operating mode is activated by entering the RUN command, either in conjunc- 
tion with a utility program invocation or by itself (to enter the ‘‘interactive’’ 
8086 mode): 


e The :Fn: portion of the pathname is the Series III directory-name. In this 
configuration, the directory-name is the equivalent of a device name, the device 
on which the filename is located. If the file is located on the system disk (:FO:), 
the directory-name may be omitted from the pathname. 


e Continuation lines are necessary when a command or invocation will not fit on 
one line. The following example illustrates the line-end conventions to use and 
the continuation characters to expect: 


> an ai ee Sep SMP LE ER USER PLB 26 <cr> 


e The LIB86 utility presents an exception to these prompt conventions. Because 
this program is interactive, it has its own prompts: 


ISIS-I11(D) 


Powe fee 


V2.0 
or later 


V1.0 orlater_ . 
V1.0 or later 
V1.0 or later 
V1.0 or later 


V1.3 «| V1.2 V1.3 
or later or later 


V2.0 
or later 
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Related Publications 
The following manuals may be helpful during various aspects of your work with 
iAPX 86,88 utilities on the Series IT]: 


© Intellec Series III Microcomputer Development System Product Overview, 
order number 121575 


e jiAPX 86,88 User’s Manual, order number 210201 


e Intellec Series IH Microcomputer Development System Console Operating 
Instructions , order number 121609 . 


@ Intellec Series III Microcomputer Development System Programmer’s 


Reference Manual, order number 121618 
© PASCAL-86 User’s Guide, order number 121539 
e PL/M-86 User’s Guide, order number 121636. 
e ASM86 Language Reference Manual, order number 121703 


© 8086/8087/8088 Macro Assembler Operating Instructions for &086-Based 
Development Systems, order number 121674 


© 8089 Macro Assembler User’s Guide, order number 9800938 
© FORTRAN-S86 User’s Guide,.order number 121570 


Program Development Examples 


The following examples are programming problems solved by using one or more of 
the iAPX 86,88 utilities on the Series III to develop code for an 8086-based host. 


Example 1: Preparing to Use DEBUG-86 


There are only two steps to preparing your code for execution: translating the code, 
then linking it with BIND. 


First you must translate your code. Any of the 8086 translators will work. An 
example of one such translation is shown below: 


mRUN PLM&6 iF 


Once the program has been translated, you must then link the program with the 
BIND control. LINK86 with BIND produces an LTL module — the loader assigns 
addresses-to the LTL modules at load time. This operation can be performed by the 
8086 loader, RUN. The operation and control of both of these programs is given in 
the Intellec Series III Microcomputer Development System Console Operating 
Instructions . 


The invocation line for LINK86 when linking the program shown above might 
appear as follows: 


mRUN LINK&6 


In the above example note that all of the symbol information (LINES, SYMBOLS, 
PUBLICS) is left in the output object file. This will aid you while debugging your 
program. DEBUG-86 uses the symbol information to produce diagnostic informa- 
tion on the program. 


This information is also included in the symbol table. Figure I-1 shows the print file 
from the invocation above. 
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The libraries specified resolve all of the external references in TEST.OBJ. 


After the above linkage, the program can be executed with the following command 
to the Series III: 


SERIES-111 8086 LINKER, xy 


INPUT FILES: :F6:TEST.OBJ, :FoO:UTILS.OBJ, :F6:SMALL.LIB 
QUTPUT FILE: :F6: TEST .86 
CONTROLS SPECIFIED 18 INVOCATION COMMAND: 
BIND 
DATE: MM/DDIVY TIME: 


LINK MAP OF MODULE ROOT 


LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAY 
CODE CODE 
CONST CONST 
DATA DATA 
STACK STAack 
MEMORY MEMORY 
??SEG 


INPUT MODULES INCLUDED: 
2F6 : TEST. OBJ( ROOT) 

2F6 :UTILS.OBJ (UTILITIES) 
:F6:SNALL.LIB(DQATTACA) 
3F6:SMALL.LIB(DQCLOSE) 
2F6: SMALL .LIB(DQCREATE) 


GROUP MAP 


GROUP MAME: CGROUP 
OFFSET SEGMENT NAME 
00068 CobE 


GROUP NAME: DGROUP 
OFFSET SEGMENT NAME 
o0ocon Coust 
OC148 DATA 
014aH 8 86STACK 
G5a2H MEMORY 


SYMBOL TABLE OF MODULE &00T 
BASE OFFSET TYPE SYMBOL OFFSET TYPE SYMBOL 


a(2) 0164H PUB BINDCONTROL QO4AH PUB BHODEBASE 

@(2) 0016H PUB BUFBASE O0%4H PUB BUFLEN 

a(2) OO4CH PUB CLASHNODEBASE OOSEH PUB COCOMN 

a(2) 0158H PUB COMMENTSCONTROL O16FH PUB CURRENTOVERLAYNU 


: -N 
G(2) 01718 PUB DEBUGTOGGLE OOA5H PUB DEFAULTPRIFILENA 
=ME 


MODULE WAME = ROOT 
BASE QFFSET TYPE SYMBOL OFFSET TYPE SYMBOL 


G(2) O542H SYM MEMORY QOO00H SYM COPYRIGHT 

G(2) 00148 SYM BUFLEN 0016H SYM BUFBASE 

G(1) OOF7H SYM ERROR OOFEH SYM WARNING 

G(2) 0018H SYM LASTHMNODEP OO1AH SYM FIRSTNMNODEP 

G(2) O01CH SYM LASTSGNODEP OO1EH SYM FIRSTSGNODEP 

G(2) O0020H SYM LASTTDNODEP GO22H SYM FIRSTTDNODEP 
. G(2) 0024H SYM LASTEXNODEP 00268 SYM FIRSTEXNODEP 


G(1) OOASH LIN 141 G(T) O0B3H 
G(1) OOBEHK LIN 144 G(1) oocés8H 
G(1) OOCFH LIN 146 G(1) ooD2H 
G(1) _OODDh LIN 149 G(1) OOERTH 
G(1) OOEEH LIN 152 G(1) OOF5H 


REFERENCES TO SEGMENT BASES EXIST IN INPUT MODULES: 
ROOT 


Figure I-1. LINK86 Print File for Bound Object Module 
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Although we do not recommend it, it is possible to execute an absolute object 
module with DEBUG-86. However, the module must be located in free user 
memory. DEBUG-86 uses the address from OFCO00H to OFFFFFH, and RUN uses 
the address from 00H to 77FFH. All other memory is available. However, if your 
system does not have a full megabyte of memory, there may be other areas that must 
be reserved. You can use the RESERVE control to prevent LOC86 from using these 


areas. 


The following invocation line is an example of how :F6:TEST.86 might be located; 
although :F6:TEST.86 has been bound, programs that are to be located for execu- 
tion on the Series III need not be bound: 


RUN LOC 8 6 
>> 


>FO:TEST.86 RESERVECOOH TO 77FFH,OFCOO0H &<cr> 
WF REP PH) <or> 


The print file produced from the above invocation is shown in figure I-2. 


SERIES-III 8086 LOCATER, 


INPUT FILE: 
OUTPUT FILE: 


3F6:TEST.86 
:F6: TEST 


. CONTROLS SPECIFIED IN INVOCATION COMMAND: 
RESERVE(OOH TO 77FFH,OFCOOOH TO OFFFFFH) 


DATE: MM/DD/YY TIME: 


SYMBOL TABLE OF MODULE ROOT 

BASE OFFSET TYPE SYMBOL 

O7B8H 014CH PUB BINDCONTROL 
07B8H 0034H PUB CLASHNODEBASE 
07B8H 0140H PUB COMMENTSCONTROL 
O7B8H 0159H PUB DEBUGTOGGLE 
O7B8H 0048H EXCEPTION 


O7B8H 0054H PUB FBLOCKBASE 
O7B8H 0052H FBLOCKLISTTAIL 


MEMORY MAP OF MODULE ROOT 


MODULE START ADDRESS PARAGRAPH = 0811H OFFSET 


SEGMENT MAP 


START STOP LENGTH ALIGN NAME 
O7500H O7B7CH O3575H CODE 
O7B80H 07 B80H 0000h CONST 
O7560H O7D11H 0192H DATA 
07012H 06109H O3F6H STACK 
0810AB O810AK 0000H MEMORY 
08110H 06126H 0019h 
-DE 
06130H 06130H OOOOH ?7SEG 


GROUP MAP 


ADDRESS GROUP OR SEGMENT NAME 
07800H CGROUP 

CODE 
07B80H DG ROUP 

CONST 

DATA 

STACK 

MEMORY 


?7L0Cb6_INITCO 


OFFSET 


0032H 
OO46H 
0157H 


OO8DH 


OO2EH 
0050H 
0123H 


= 0006H 


CLASS 


CODE 
CONST 
DATA 
STACK 
MEMORY 
CODE 


TYPE SYMBOL 


BNODEBASE 

COCONN 

CURRENTOVERLAYNU 
~M 

DEFAULTPRTFILENA 
~-ME 

FANODEBASE 

FBLOCKLISTHEAD 

FBLOCKSEQUENCENU 
-MBER 


OVERLAY 


Figure I-2. LOC86 Print File for Bound Object Module 
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Example 2: Preparing to Use an ICE-86 System 


Another way to test and debug software is using in-circuit emulation (ICE) system. 
The ICE-86 loader can load only absolute object modules. Therefore, you cannot 
use the output from LINK86 immediately; it must be located too. 


The whole process of preparing a program for ICE-86 execution takes three steps. 
The first two are the same as in Example 1: the program must be translated and 
linked: 


mRUN LINK86 :F6: 


The above example shows a straightforward linkage with no change to the default 
control setting. Note that NOOVERLAY and NOBIND, the defaults, are set. The 
ICE-86 loader has no facility for dealing with overlay modules created by using the 
LINK86 OVERLAY control. In this case there are no unresolved external references 
in the object module. If the module did contain unresolved references, it could still 
be executed by the ICE-86 system. However, as with execution under DEBUG-86, 
executing instructions that contain unresolved references will produce undefined 
results. 


Figure I-3 shows the print file produced during the invocation shown above. 
LINK86 does not produce a symbol table with NOBIND is in effect. 


The last step before ICE-86 execution is transforming the relocatablé object module 
into an absolute object module with LOC86. The invocation line shown below 
would produce an object file that could be loaded and executed by the ICE-86 
Emulator: 


mRUN LOC86 :FO:1C LNA SES 


SERIES«III 8086 LINKER, Vxy 


INPUT FILES: :F6:ICETST.OBJ, :F6:SMALL.LIB 
OUTPUT FILE: :F6:ICETST.LAK 

CONTROLS SPECIFIED IN  SRVOCATION COMMAND: 
DATE: MM/DD/YY TIME 


LINK MAP OF MODULE LOANER 


LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ee SEGMENT CLASS OVERLAY 
CODE 
CONST 
DATA 
STACK 
MEMORY 


INPUT MODULES INCLUDED: 

F6 : LCETST .OBJ( LOANER ) 
:P6 :SMALL. LIB(DQATTACH ) 
2 F6 : SMALL .LIB(DQCLOSE ) 
:F6:SMALL.LIB(DQCREATE ) 
:F6 : SMALL.L1B(DQDETACH ) 
:F6 : SMALL.LIB(DQEXIT) 
2 F6: SMALL ..LIB(DQGETSYSTEMID) 
:F6: SMALL .~LIB(DQOPEN) 
: F6 : SMALL .LIB(DQOVERLAY ) 
:F6:SMALL.LIB(DQWRITE) 
:P6 : SMALL .LIB(SYSTEMSTACK) 


Figure I-3. LINK86 Default Print File 
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This invocation line shows LOC86 invoked with the default control setting.. Note 
that the INITCODE control is in effect by default. 


The PL/M-86 program ICETST.SRC is ready for execution on an ICE-86 system. 


Example 3: Using CREF86 


Figure I-4 illustrates a CREF86 cross-reference listing for an input list of 15 files, 
one of which contains several modules. The output print file pathname OUT and a 
title for the listing were specified in the controls. Although PAGEWIDTH (PW) and 
PAGELENGTH (PL) specifications were also noted in the controls, the numbers 
specified are the same as those provided by default. 


PAGE 


 CREF86 EXAMPLE OF CROSS REFERENCE USING CREF86 


SERIES-III CREF86 yxy 


sEV: UTILS OBJ 
2FT:LSUTIL. OBJ 


INPUT FILES: 3F1:ROOT.OBJ 
3F 1S MEMMAN.OBJ 


3F1:SORT.OBJ 


:F1:PARSE.OBJ 
3F1:SCANNR.OBJ 
:£ 1: 0DSMA.LNE 


3F1:SIGHON.OBJ 
3F13 PROCES .OBJ 
COMP AC .LEB 


sPI:STATE.OBJ 
:F1:SCUTIL .OBJ 


:F13ERROR.OBJ 
3F1:LIST .OBJ 


OUTPUT FILE: 
CONTROLS SPECIFIED: 


MODDLES INCLUDED: 
FILE NAME 


3F 1: ROOT .OBJ: 

2F1:PARSE.OBJ: 
:F1:SIGHON .OBJ: 
3F1:STATE.OBS: 
:F1T:ERROR.OBJ: 
sF1TsUTILS .OBJ: 
:F17:MEMMAN OBJ: 
3F1:SCANNR .OBJ: 
:F1:PROCES.OBJ: 
:F1:SCUTIL.OBJ: 
tP1:LIST.OBJ: 

sF1:LSUTIL.OBJ: 
:F1:SORT.OBJ: 

:F1:U0DSMA.LAEK: 


out 


PRCOUT) TI(EXAMPLE OF CROSS REFERENCE USING CREFS6) PW(120) PL(60) 


MODULE NAME(S) 


CREF86 

PARSE 

SIGHON 
HEXTSTATE 
ERROR 
UTILITIES 
MEMORYMANAGEMENT 
SCANMODULES 
PROCESSRECORDS 
SCANUTILITIES 
LISTOUTPUT 
LISTUTILITIES 
SYMBOLSORT 
OBJMAN 


DQCREATE 
DQGETARGUMENT 
DQSEEK 


COMPAC.LIB: DQALLOCATE 
DQDETACH 
DQGETTIME 


SYSTEMSTACK 


DQATTACE 
DQEXIT 
DQOPER 


DQCHANGEEXTENSION 
DQFREE 
DQREAD 


DQDECODEEXCEPTION 
DQGETSYSTEMID 
DQURITE 


CREFS6 EXAMPLE OF CROSS -REFERBSCE USING CREFS6 MM/DD/YY 


SYMBOL NAME SYMBOL TYPE DEFINING MGDULE; REFERRING MODOLE(S) 


UNKNOWN 
UNKNOWN 
PROCEDURE 
PROCEDURE 


ACCESS_PAGE . . 
ALLOCATE. . . . 
APPENDNODE. . . 
APPENDUDSMNODE. 


UTILITIES 


UTILITIES; PARSE SCANMODULES PROCESSRECORDS 


ARRAYBASE . . . 
ATOI. 2. 2. 2 2 


BTOX. . «© es «© « 
BUBBLESORTVARNAMES. 
BUMPLINECOUNT ... 


CHECKHEADER . 
CHECKOVERLAY. 
CHECKVARTYFE. 


REF86 &XAMPLE OF 


UNLOAD_PAGE . .. 


VARAREAP. . 2. 6. 
VBLOCKLISTHEADER. 


WARNING . 2. 6 © « 
WRITEDATA . 2. © 
WRITEINITLINEBUF. 
WRITELINE . .. . 
WRITENEWLINE. . . 
WRITETOCOMMANDBUF 
WRITETOFILE ... 


ZERO. . - 


POINTER 
PROCEDURE 


PROCEDURE 
PROCEDURE 
PROCEDURE 


PROCEDURE 
PROCEDURE 
OkKOCEDURE 


CROSS REFERENCE USING 


UNKNOWN 


POINTER 
WORD 


PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 
PROCEDURE 


WORD 


CREF&6 


SYMBOLSORT; 
UTILITIES; 


UTILITIES; 
SYMBOLSORT; 
LISTUTILITIES; 


SCANUTILITIES; 
SCANUTILITIES; 
SCANUTILITIES ; 


OBJMAN 


MEMORY MANAGEMENT ; 
PROCESSKECORDS; 


ERROR; 

LISTUTILITIES ; 
LISTUTILITIES; 
LISTUTILITIES; 
LISTUTILITIES ; 
PARSE 

LISTUTILITIES ; 


UTILITIES 


LISTOUTPUT 
PARSE 


LISTUTILITIES 
LISTOUTPUT 
LISTOUTPUT 


SCANMODULES 
SCANMODULES 
PROCESSHECGRDS 


MM/DD/YY 


PROCESSRECORDS LISTOUTPUT SYMBOLSORT 
UTILITIES LISTOUTPUT SYMBOLSORT 


SCANMODULES PROCESSRECORDS 

ERROR UTILITIES LISTOUTPUT 
ERROR UTILITIES LISTOUTPUT 
LISTOUTPUT 
UTILITIES LISTGUTPUT 


ERROR LISTOUTPUT 


Figure I-4. CREF86 Cross-Reference Listing 
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Example 4: Building and Using Library Files 


A library is a file that contains object modules. Libraries allow you to collect 
commonly used pieces of software into one file. The library file can be included in a 
LINK86 invocation,.and LINK86 will use the modules to resolve references. 


You can add the output from a translator, LINK86, or LOC86 to a library. The 
modules added may be relocatable or absolute; they can have unresolved references 
or be completely linked. 


Let’s consider the following scenario — we have created six routines (SINE, 
COSINE, TANGENT, COSECANT, SECANT, and COTANGENT). We want to 
create a library file that will allow each routine to be linked to programs separately. 


The first step necessary to create the library is to translate each routine separately. If 
we were to put them in a single source module, the translator would translate them 
into one module with six public symbols. We could add this module to a library, but 
when we tried to link one of the routines into a program, all six would be included. 


Once the routines are translated, LIB86 can be used to create a library file and add 
modules. The LIST command is used to display the contents of the library and the 
publics contained within it. 


C 
COSECANT 
COT 
COTANGENT 
TAN 
TANGENT 
ne, 
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Example 5: Linking and Locating Programs with | 
Overlays Using OVERLAY Control 


The easiest way to build an 8086 program that contain overlays is with LINK86’s 
OVERLAY control. Overlay modules built with this control reside in the same file 
as the root. The operating system supplies routines that will load the overlays con- 
structed in this way. See Intellec Series III Microcomputer Development System 
Programmer’s Reference. 


After the program modules that will constitute the root and its overlays are 
translated, each of the overlays and the root must be linked separately. Then the 
root and all of the overlays are linked together. 


The example below shows the first step toward linking overlays—linking all of the 
modules that will constitute each overlay and the root separately: 


mR UN LINK86 OV1.08 Birereiey ae ot oe 
PRAOVERLAYCOVERLAY14 


RUN LINK&6 atee Wloe Se eee 
PRIOVZ.UNK CY Teeee 


RUN LINK86 Loe. De ER AY COVERLAYS) <2 
mRUN LINK86 


RUN LINK&6 
PSYSMALL.LIB 


Notice that all of the modules, including the root, are linked with the OVERLAY 
and NOBIND controls. The overlay name for the root is not as critical as for the 
overlays, since the overlay name is used when calling the loader. 


Finally, the overlays and root must be linked together. Since any one of the files 
could be the root, LINK86 requires that for the final link the file containing the root 
must be first in the input list. During this final the OVERLAY control is not used: 


mRUN LINK86 ROOT.LNK, 947%. OV3.UNK, &¥<cr> 


PRAOV4.LNK TO PROG.86<c7> 


In the invocation, the optional BIND control is specified. The resulting object file is 
executable on a Series III. 


Figure I-S shows the LINK86 print file listing for the above invocation. 


There is nothing special about the invocation line to LOC86 when locating a file that 
contains overlays or that has been bound: 


RUN LOC86 PROG.86 RESERVE 
PRAQECOQQH TO QFFFFFH)<cx> 


The RESERVE control prevents LOC86 from assigning memory addresses reserved 
for the operating system. Figure I-6 illustrates the printout from this invocation. 
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SERIES-111 6056 LINKER, Vxy. 


IMPUT FILES: ROOT.LEK, OV1.LMK, OV2.LNK, OV3.LEK, OVS LOK 
OUTPUT FILE: PROG.&6 
CONTROLS SPECIFIED If INVOCATION COMMAND: 
BIND 
DATE: MM/DD/YY TIME: 


LINK MAP OF MODULE ROOT 


LOGICAL SEGMENTS INCLUDED: 

LENGTH ADDRESS ALIGN SEGMENT OVERLAY 
3CETH ------ G cope ROOT 
QDOOH ------ G CONST ROOT 
2840H ------ G DATA ROOT 


INPUT MODULES INCLUDED: 
ROOT. LNK( ROOT) 
OV1.LNK(PARSE) 
OV2.LNK(ILUDE ) 
OV3.LEK(PICILUDE) 
OV4.LRK(FASTLOAD ) 


GROUP MAP 


GROUP NAME: CGROUP 
OFFSET SEGMENT NAME 
ooo0n CODE\CODE\ROOT 
3CEGH CODE\CODE\PASS1 
3CBE6H CODE\CODE\PASS2 


SYMBOL TABLE OF MODULE ROOT 
BASE OFFSET TYPE SYMBOL OFFSET TYPE SYMBOL 


G(2) 251CH PUB ACTUAL OFODH PUB ASSUMEROOTCONTRO 
-L 

G{2) OF22H PUB BASEFIXUPSEXIST i OFOCh PUB BINDCONTROL 

G(2) OD26H PUB BHODEID 24EAH PUB BUFEBASE 

G(2) OD25H PUB CLASENODEID OD5aH PUB COCONN 

g(2) OFOOKH PUB COMMENTSCONTROL OFSOH PUB CURRENTFILNUM 

G(2) OF1AH PUB CURRENTOVERLAYAU OFSEH PUB CURRENTRECINDEX 
-M ; 


OVERLAY NAME = ROOT, MODULE NAME = ROOT 


BASE © OFFSET TYPE SYMBOL OFFSET SYMBOL 


G@(2) 4A2OH SYM MEMORY 00028 COPYRIGHT 
G(2) ODOOH SYM LASTHMNODEID oD02H FIRSTNMNODEID 
(2) ODOSH SYM LASTSGNODEID OD068 FIRSTSGNODEID 
G(2) OD08H SYM LASTIDNODEID ODOAR FIRSTTDNODEID 
G(2) ODOCH SYM LASTEXNODEID ODOEH FIRSTEXNODEID 
G(2) OD10H SYM LASTGRNODEID 0D12H FIRSTGRNODEID 
G{2) OD1SH SYM LASTOVNODEID OD168 FIRSTOVNODEID 
G(2) OD16H SYM LASTGHODEID 00148 FIRSTBNODEID 


OVERLAY WAME = ROOT, MODULE NAME 
BASE OFFSET TYPE SYMBOL OFFSET SYMBOL 


G(2) 4A20H SYM MEMORY 003CH SGNODE 

G(2) OF56H SYM LITBASE OF58H LITID 

G(2) OF56H BAS LITNODE OF5AH FIRSTNODEIDS 
G(2) OF64H SYM FIRSTNODE OF8EH CURRENTRECINDEX 
a(2) OF96H SYM TEMPLATE OFBOR II 

@(1) 016EH SYM GETLIT 00068 INDEX 

STACK ooo4sH SYM I 02078 SGLIT 


Figure I-5. LINK86 Listing for Program with Overlays 
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SERIES-I1I 6066 LOCATEh, Vxy 

INPUT FILE: PROG.66 

OUTPUT FILE: PROG 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 
RESSRVE(OH TO 77FFH,OFCOOOH TO OFFFFrH) 

DATE: MM/DD/YY TIME: 


SYMBOL TABLE OF MODULE ROOT 


BASE OFFSET TYPE SYMBOL 


1034H 


1034H 
1034H 
1034H 
1034H 
1034H 


251CH PUB ACTUAL 
BASEFIXUPSEXIST 
BNODEID 
CLASHNODEID 
COMMENTSCONTROL 
CURRENTOVERLAYNU 
-M 


PUB 
PUB 
PUB 
PUB 
PUB 


OF22H 
OD26H 
0D28H 
OFOOH 
OFTAH 


OVERLAY = ROOT, MODULE = ROOT 


BASE OFFSET TYPE SYMBOL 
10348 
1034H 
10348 
10348 
10348 
10348 
1034H 
10348 
10348 


4A20H 
ODOOH 
ODOSH 
ODO8H 
ODOCH 
OD108 
OD14H 
oD18H 
ODICH 


SYM 
SYM 
SYM 
SIM 
SYM 
SYM 
SYM 
SYM 
SYM 


MEMORY 
LASTNMNODEID 
LASTSGNODEID 
LASTTDNODEID 
LASTEXNODEID 
LASTGRNODEID 
LASTOVNODEID 
LASTBNODEID 
SGNODEID 


OVERLAY = ROOT, MODULE = LIT 


BASE OFFSET TYPE SYMBOL 
10348 
1034H 
1034H 
10348 
1034H 
0780h 
STACK 


4A20H 
OF56H 
OF56H 
OF64H 
OF96H 
O10EH 
QO004uH 


SYM 
SYM 
SYM 
SYM 


MEMORY 
LITBASE 
LITNODE 
FIRSTNODE 
SYM TEMPLATE 
SYM GETLIT 
Sym I 


MEMORY MAP OF MODULE ROOT 


MODULE START 
SEGMENT MAP 


ADDRESS PARAGRAPH = 14D6H 


START STOP LENGTH ALIGN NAME 
07800H 
OBSESH 
OBSES&H 
OBSESH 


OBAE6R 
OFQBAH 
OEOCEH 
103378 


3CE7H 
44D3H 
2BE7H 
4E50H 


CODE 
CODE 
CODE 
CODE 


GROUP MAP 


ADDRESS 
07800H 


GROUP OR SEGMENT 
CGROUP 
CODE\CODE\ROOT 
CODE\CODE\PASS1 
CODE\CODE\PASS2 
CODE\CODE\PIC_PASS2 
CODE\CODE\FASTLOAD 
DGROUP 
CONST\CONST\ROOT 
DATA\DATA\ROOT 
STACK\STACK\ 


10340H 


BASE 
1034H 


10348H 
1034H 
1034H 
1034H 


10348 


OFFSET 


OFFSET 
OFODH 


OFOCH 
25EBAH 
OD5AaH 
OF508 
OFSEH 


OF FSET 


00028 
OD02B 
OD06H 
op0o~aAB 
ODOEH 
OD12B 
OD16H 
OD1AB 
OD1EH 


OFFSET 


003CH 
OF58H8 
OFS5SAH 
OFSER 
OFB9H 
0006H 
020748 


= 0006h 


CLASS 


CODE 
CODE 
CODE 
CODE 
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TYPE SYMBOL 


PUB 


PUB 
POB 
PUB 
PUB 
PUB 


ASSUMEROOTCONTRO 
-L 

BINDCONTROL 
BUFBASE 

COCONN 

CURRENT FILNUM 
CURRENT RECINDEX 


SYMBOL 


COPYRIGHT 
FIRSTNMNODEID 
FIRSTSGHODEID 


* FIRSTTDNODEID 


FIRSTEXNODEID 
FIRSTGRNODEID 
FIRSTOVNODEID 
FIRSTBSODEID 
GRHODEID 


SYMBOL 


SGNODE 

LITID 
FIRSTNODEIDS 
CURRENT RECINDEX 
It 


INDEX 
SGLIT 


OVERLAY 


ROOT 
PASS! 
PASS2 
PIC_PASS2 


Figure I-6 LOC86 Listing for Program with Overlays 
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Example 6: Linking and Locating Programs with Overlays 
Without OVERLAY Control 


It is harder to produce overlay modules without using the OVERLAY control. 
However, sometimes it is necessary to build programs in this way, for example, 
building a program for running under an operating system that does not support 
overlay modules contained in the same file as the root module. 


But regardless of the reason, building overlays in this fashion places an extra burden 
on the programmer. He must do some of the work that would be left to LINK86 
(and LOC86) if he were to use the OVERLAY control. In the following example we 
prepare a root and two overlay modules in separate files. 


First we must compile all modules. Examples of the invocation lines are shown 
below: 


mRUN PLME&E 


mRUN PLM&E 
mRUN PLM&6 


In the next step we must link the root module to resolve external symbols with a 
library and to obtain a link map: 


mRUN LINKS&6 sCBy 


»,USER. LIB MAP<cr> 


We will need the link map for locating purposes. The link map, shown in figure 1-7, 
shows the size of each segment in the root. Since the overlays are self-contained 
except for references to the root, we do not need a link map for them. The PL/M-86 
listing files will show the size of each overlay’s segments, as illustrated in figure 1-8. 


Note that the length of the root’s code segment and OV1’s code segment must fit 
within 64K. This means that the code for the overlays must be in a part of memory 
contiguous with the root (to avoid altering the CS register during execution). OV2’s 
CONST and DATA segments are larger than OV1’s so that the STACK segment 
must be placed to leave room for OV2’s CONST and DATA segments. If the 
overlays share the STACK and MEMORY segments with the root, they must be 
located at the same address. 


SERIES-III 8086 LINKER, vxy 

INPUT FILES: :F1:ROOT.OBJ,USER.LIB 
OUTPUT FILE: :F1:ROOT.LNK 

CONTROLS SPECIFIED IN INVOCATION COMMAND: 


MAP 
DATE: MM/DD/YY TIME: 


LINK MAP OF MODULE LOANER 


LOGICAL SEGMENTS INCLUDED: 
LENGTH ADDRESS ALIGN SEGMENT CLASS OVERLAY 
Ww CODE 


CODE 
CONST CONST 
DATA DATA 
STACK STACK 
MEMORY MEMORY 


INPUT MODULES INCLUDED: 
:F1: ROOT .OBJ( ROOT) 
2f0:USER.LIB( LOADER) 
:FO:USER.LIB(EXIT) 
2F0:USER.LIB( ERROR) 
:FO:USER.LIB( TIME) 


Figure I-7. LINK86 Map for Root File 
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‘OV1's segment size information 


MODULE INFORMATION: 


CODE AREA SIZE 
CONSTANT AREA SIZE 
VARIABLE AREA SIZE 
MAXIMUM STACK SIZE 
918 LINES READ 
0 PROGRAM ERRORS) 


END OF PL/M-86 COMPILATION 


this is the CODE segment 
this is the CONST segment 
this is the DATA segment 
this is the STACK segment 


OV2's segment size information 
MODULE INFORMATION 


CODE AREA SIZE 
CONSTANT AREA SIZE 
VARIABLE AREA SIZE 
MAXIMUM STACK SIZE 
918 LINES READ 
QO PROGRAM ERROR(S) 


END OF PL/M-86 COMPILATION 


7 
1 


066 this ts the CODE segment 
257 this is the CONST segment 
108 this is the DATA segment 
103 this its the STACK segment 


wun 
200—> 
Ofr-w 
AMnovw 
N= > 
i 


Figure I-8. Module Information for Overlays 


After computing the required location for the root’s DGROUP and STACK, we can 
locate the root module. The resulting file will not be executable, but it allows us to 
resolve references.to the root’s code and data symbols in the overlays. The following 
LOC86 invocation will leave room for the overlays’ code segments and place the 
DGROUP in the first unused memory location. (In the command line below, the DS 
register is initialized to OFFCEH, and the CS register is initialized to 0.) The STACK 
and MEMORY segments will be located above OV2’s DATA segment: 


Once the root is located, we can use it to resolve external references in the overlay 
modules. The overlay modules cannot call each other, since only one is resident in 
memory at any time. The link commands are shown below. The NOPUBLICS with 
the EXCEPT control is used to avoid conflicts when we use the located overlays to 
resolve external references in the root: 


The PUBLICSONLY control resolves references to public symbols contained in the 
root. 


N 
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After the overlays have been linked; they must be located. The code and data 
segments must be placed in the memory locations that were reserved when we first 
located the root. In this case the STACK and MEMORY segments must be the same 
for the overlays and the root: 


&<cor> 


The CGROUP and DGROUP base address must be specified in order to compute 
offset information. The final base address assigned to DGROUP by LOC86 will be 
rounded up to OFFDOH. 


Once the overlays are located, the root is linked and located into an executable form. 
The PUBLICSONLY control will resolve references to symbols in the overlay 
modules. Other than the addition of this input control, the LINK86 and LOC86 
command must be identical to those used previously: 


The executable forms of the root and its overlay files are contained in :F1:ROOT, 
:F1:,OV1, and :F1:OV2. Figure I-9 shows the resulting layout of memory. 


ROOT CODE 
SPACE 


8A9B 
8A9C 


OVERLAY 


CODE 
SPACE 


TOFFCO «——- DS. SS 
OFFCE 


ROOT DATA 
SPACE 


OVERLAY 
DATA 
SPACE 


STACK AREA 


MEMORY 


Figure I-9. Memory Organization for Example 6 121616-10 
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Example 7: Linking 8089 Programs with 8086 Programs 


The process of linking and locating 8086 programs with 8089 programs that use 8089 
local memory is very similar to creating overlay modules in separate files. 


Let us consider the following example: we have created an 8086 program and two 
8089 program modules. The 8089 programs reference each other’s symbols and. 
public symbols in the 8086 program. In addition, one of the 8089 programs must be 
resident in 8089 local memory. 


The first step is to translate the programs. The 8089 program modules must be 
translated separately, since they will be located in different 8089 address spaces. The 
following lines illustrate the invocation lines to the translators: 


FS TASK AGU < er 


TASK2 should be linked and located first for 8089 local memory. This linkage will 
leave unresolved external references, but it is needed to resolve the references in 
TASKI: 


~ Tae 


mRUN LOC86 
The RESERVE control in the locate above is a precaution to avoid exceeding 64K. 


The next step is to link and locate the object modules that will reside in the 8086’s 
address space. The external references to the 8089 program module that is resident in 
8089 local memory are resolved with the PUBLICSONLY control. The invocation 
lines for linking and locating the modules are: 


LINK&6 
heey sb leo k Obey 
ICSONLYCSFA:TASK2) 


:F1:86N89 contains an absolute object module that includes PROG86 and TASK1. 
It may be loaded and executed on an 8086-based system. However, the 8089 pro- 
gram to be located in 8089 local memory still has some unresolved external 
references. To resolve those references we must relink with PUBLICSONLY and 
relocate. The invocation lines to LINK86 and LOC86 shown below are identical to 
those used earlier. This is necessary to guarantee that the references resolved earlier 
are not invalidated: 


—Eeean &<or> 


> >FeauEe} 


NK86 :FI:TASK2.0Bu,8089.LIB, 
CSONLY(C3F1:86N89) <cr> 


ca 
a 
T 
. 


L 
L 


1OQ00H TO QFFFFFH) <cr> 


NOTE 


The example above makes many assumptions about the 8089 and 8086 code 
that it deals with. In most practical situations it is usually necessary to use a 
more complex LINK86 and LOC86 invocation. However, the example 
above illustrates the key linking and locating principles underlying 
ASM86/ASM89 module combination. 
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Invocation Examples 


The following foldout pages contain examples of the iAP X 86,88 Family utility con- 
trols and commands. The examples, all in the ‘‘interactive 8086’’ mode, may be used 
in conjunction with syntax specifications given: 


e In Chapter 2 for LINK86 
e In Chapter 3 for CREF86 
e In Chapter 4 for LIB86 

e In Chapter 5 for LOC86 


When using the directions in these chapters, fold out the page in this appendix con- 
taining examples of the command or control you are interested in. 


The following is a sample Series III OH86 invocation: 


maCH8G :F3:D0NE TO 


Poe IN HEX COND 
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Comments 


This example defines two public symbols, VARONE 
and VARTWO, with absolute addresses 50H and 
2000H, respectively. 


In this example the root file is RTFILE and LIB1 and 
LIB2 are library files. 


This line creates an LTL module. The output object 
file is TEST with no extension. 


This example specifies default to avoid ambiguity. 


LINES is the default, so it need not be specified. 


This MEMPOOL example will increase the minimum 
dynamic memory requirements by 20H bytes, and by 
default the maximum size will increase, if necessary, 
to equal the minimum. 


The minimum dynamic memory requirement is 100H. 
The maximum dynamic memory requirement is 
300H. 


Control 
ASSIGN 


ASSUMEROOT 


BIND/NOBIND 


COMMENTS/NOCOMMENTS 


FASTLOAD/NOFASTLOAD 


INITCODE 
LINES/NOLINES 


MAP/NOMAP 


MEMPOOL 


SERIES Il! LINK86 EXAMPLES 


Examples 


PaLINK86 FILE1, FILE2, FILE3 ASSIGN &¥<cr> 
MPa VARONECSOH), VARTWO(2000))<cr> 


PaLINK86 ROOT1.0BJ, ROOTZ.OBJ, LIB1, &¥<cr> 
Peal IBe TO RTFILE OVERLAY<cr> 


PALINK86 OV11.0BJ, OV12.0BJ, LIB1, &¥<cr> 
PPaLIB2 TO OV1.O0BJ OVERLAY &<cr> 
PPAASSUMEROOTC(RTFILE) <cr> 


MALINK86 OV21.0BJ, OV22.0BJ, LIB1, &<cr> 
peaLIBe TO OV2.0BJ OVERLAY &<cr> 
PPAASSUMEROOTCRTFILE) <cr> 


PLINK86 RTFILE, OV1.0BJ, OV2.0BU &<cr> 
pal O PROG<cr> 


MaLINK86 TEST.OBJ,USER.LIB BIND PRINT<cr> 


MALINK86 GEN.OBJ NOBIND<cr> 


PALINK86 :F1:SOURCE.OBJ NOCOMMENTS <cr> 


aLINK86 :F1:PROG.OBU TO &<cr> 
pee. F 1: TEMP. TST COMMENTS <c.r> 


PALINK86 PROG.OBJ, LIB1, LIB2 BIND &<cr> 
Pear ASTLOADK<cr> 


PILINK86 :FIIMYPROG INITCODE<cr> 
MLINK86 :F1:RUN.OBJ NOLINES<cr> 


PLINK86 :F1:TEST.OBJ 


SLINK86 :FI:TESTER.OBJ MAP<cr> 


LINES<cr> 


SLINKS6.86 :F3:MAIN.OBJ,USER.OBJ, &<cr> 
SSIPUBLICSONLY(:F2:8089.LOC) NOMAP<cr> 


MaLINKS86 :FI:TEST.OBJ,USER.LIB, &¥<cr> 
PPaPASCAL.LIB BIND MEMPOOL(+20H) <cr> 


MaLINK86 :FI:TESTED.OBJ MEMPOOL &<cr> 
aC i00H,+200H) BIND<cr> 
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Comments 


The LINK86 output module will have the name 
specified in parentheses in the control. 


This example removes all debug and public records 
from the object file. 


The EXCEPT in the NOPUBLICS overrides the 
PURGE. 


This use of ORDER specifies the order of segments 
for two groups. 


This example will create an overlay record, and the 
name of the overlay wil be OVERLAY1. 


First the constituent files must be linked to form 
overlays. 


The print file is :F1:TEMP1.MP1. 


The print file is :F1:PROG.MP1. 

The print file is :F1: THE.MAP. 

This example removes information about line 
numbers, local symbols, and comments from the 
print file. 


This statement removes all but the segment informa- 
tion and error messages from the print file. 


Control 
NAME 


OBJECTCONTROLS 


ORDER 


OVERLAY/NOOVERLAY 


PRINT/NOPRINT 


PRINT CONTROLS 


SERIES Ili LINK86 EXAMPLES 


Examples 


LINK86 :F1:TOM.OBJ,SYS.LIB NAME &<cr> 
PSY(THIS 1S A VERY LONG MODULE@NAME.) <cr> 


PALINK86 :F1:SRC1.0BU,:F1:SRC2.0BU, &¥<cr> 


pea. F 3 :USER.LIB NAMEC(TEST 5.3) <cr> 


MALINK86 :FY:FINAL, USER.LIB, &¥<cr> 
PeaSYS. LIB OBJECTCONTROLS (PURGE) <cr> 


PALINK86 :F3:PASCL1.OBJ &¥<cr> 
PAO BJECTCONTROLS(PURGE,NOPUBLICS &<cr> 
PPaEXCEPTCSTART, DATA1, DATA2))<cr> 


PALINK86 :FO:PLMPRG.OBJ, PLM86.LIB, &<cr> 
PPaSMALL.LIB, USER.LIB &<cr> 
PPAORDER(DGROUPCSEG1,SEG2\CLASS1, &<cr> 
PPASEGZ\CLASSI\OVERLAY1), &¥<cr> 

Pac GROUP CCSEG1,CSEG2,CSEG3))<cr> 


PALINK86 FILE1,FILE2, FILES TO &¥<cr> 
pea: F 1: O0V1.LNK OVERLAY (OVERLAY1) <cr> 


MLINK86 FILE4,FILE5,FILE6 TO &X<cr> 
Pea FL 0V2.LNK OVERLAY (OVERLAY 2) <cr> 


PALINK86 FILE?,FILE8,FILEDS TO &X<cr> 
pea. FL ROOT.LNK OVERLAY (ROOT) <cr> 


PALINK86 :FIT:ROOT.LNK,:FT:OV1.LNK, &<cr> 


yea fF 1 :0V2.UNK<cr> 


MALINK86 :F1:PROG.OBJ TO &<cr> 
pea: F 13 TEMP1.TST PRINT<cr> 


PALINK86 :F1:PROG.OBJ<cr> 


PALINK86 :F1:PROG.OBJ, &¥<cr> 
PPAUSER.LIB PRINTC: FIT: THE.MAP) <cr> 


PALINK86 :F2:TEMP.OBJ &<cr> 
PPABIND PRINTCONTROLS(NOLINES, &<cr> 
PPANOCOMMENTS, NOSYMBOLS)<cr> 


PALINK86 :F3:PASCL1.0BJ &¥<cr> 


PPAPRINTCONTROLS (PURGE) <cr> 
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Comments 


Public information concerning only DATA1, DATA2, 
LABEL3, and PROC4 is placed in the object file and 
print file. 


All public symbol information will be included in both 
the print file and output file. 


This example will produce a file containing only the 
absolute public symbol records from :F1:8089.LOC. 
The object file will be :F1:8089.LNK. 


This will resolve the references in ROOT.OBJ to 
absolute public symbols in the separately linked and 
located overlays OV1 and OV2. 


This produces an object file containing no debug or 
public information. 


This confirms that the line and symbol information 
should be kept in the print file. 


This will change the translator-assigned name 
CGROUP to THE@CODE. A subsequent linkage 
would not combine THE@CODE with a group named 
CGROUP. 


This changes the name of the CODE group to 
CGROUP. 


This tells the loader that 15FFH bytes of code is the 
minimum requirement for MEMORY. The new max- 
imum size of MEMORY is 35FFH. 


This increments MEMORY’s minimum size by 1FFH 
(7951D) bytes. The maximum size of MEMORY is 
equal to the old minimum size plus 3FEH (15902D). 


The local symbol records will be included in the 
object file. 


PURGE is a shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, NOTYPE, and 
NOLINES. 


SYMBOLCOLUMNS has no effect, since BIND was 
not specified. 


The symbol table will be printed on a line printer. 


LIBMOD will retain its type information. 


Control 
PUBLICS/NOPUBLICS 


PUBLICSONLY 


PURGE/NOPURGE 


RENAMEGROUPS 


SEGSIZE 


SYMBOLS/NOSYMBOLS 


SYMBOLCOLUMNS 


TYPE/NOTYPE 


SERIES Il LINK86 EXAMPLES 


Examples 


PALINKS6 sFI:TEST.OBJ,USER.LIB &<cr> 
PPANOPUBLICS EXCEPT(DATA1, DATA2, &¥<cr> 
PPALABEL3,PROC4) <cr> . 


PaLINKS86 :F4:TEMP.OBJ,SMALL.LIB, &<cr> 


PPAUSER. LIB PUBLICS<cr> 


ALINK86 PUBLICSONLY (:F1:8089.L0C)<cr> 


PaLINK86 :FI:ROOT.OBJ, &K<cr> 
PPaPUBLICSONLY(C:F1:0V1,:F1:0V2) <cr> 


MLINK86 :FI:INDEX.OBJ PURGE<cr> 


ALINK86 :F3:FINAL.OBJ PRINTCONTROLS &<cr> 
ya NOPURGE)<cr> 


PALINK86 :F1:PLMPRG.OBJ RENAMEGROUPS &<cr> 
Mea CGROUP TO THEACODE)<cr> 


MALINK86 :FOZASMPRG.OBJ &<cr> 
PPARENAMEGROUPS(CODE TO CGROUP)<cr> 


MLINK86 :F7:GEORGE.OBJ, USER.LIB, &¥<cr> 
MPASYSTEM.LIB BIND SEGSIZE(MEMORY &¥<cr> 
(C1TSFFH,+2000H))<cr> 


PALINK86 :F4:PROUCT.OBU, &¥<cr> 


PPAREST.LIB SEGSIZE (MEMORY (+1FF,+1FF))<cr> 


PMaLINK86 :F1:TEMP.OBJ,USER.LIB &<cr> 
PPANOSYMBOLS SYMBOLS<cr> 


aL INK86 


>F3:TEST.OBJ,USER.LIB PURGE<cr> 


PaLINK86 :F1:TEST.OBJ SYMBOLCOLUMNS (1) <cr> 


PaLINK86 :FI:ROOT.LNK, 2 FT: OV1.LNK, 


PaLINK86 :F1:LIBMOD.OBJ TYPE<cr> 
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Comments Control 


The cross-reference listing will have 35 lines on each 
page. 


The cross-reference listing will be 100 characters 
wide maximum per page. 


The pathname of the print file will be :F1:MYFILE. 
The message in the TITLE control must be placed on 


one line. If the message contains special characters, 
it must be enclosed in single quotes (’). 


PAGELENGTH 


PAGEWIDTH 


PRINT 


TITLE 


SERIES Ili CREF 86 EXAMPLES 


Examples 


PACREF86 :FL:FILE1, FILE.LIB &¥<cr> 
PPAPAGELENGTH(35)<cr> 


PaCREF 86 :F1:PROG, :FI:LIB(MOD1) &¥<cr> 
PPAaPAGEWIDTH(100) <cr> 


PACREF86 :F2:FILES(MODULE1,MODULE2) &<cr> 
PRAPRINTC:FI:MYFILE) <cr> 


PCREF86 MYPROG,HISPROG,HERPROG, &<cr> 
PSINYLIB,HISLIB,HERLIB TITLE &<cr> 


pa ' A CROSS-REFERENCE') &cr> 
PPaPAGEWIDTH(105)<cr> 
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Comments 


Three object files are added to the USER.LIB. 


Three modules from the library LIB.ABC are added 
to :F3:PROJ.TOM. 


This command will produce an empty library file 
called TOMS.LIB. 


Four modules are deleted from the library USER.LIB. 


SERIES I!!1 LIB86 EXAMPLES 


Control Examples 


ADD ADD :F1:SIN, 
pee FOSUSER.LI 


PE -TetOS of PU STAN- TO AS ir + 
B<cr> 


BADD : LIB.ABC(MOD1, 
* * PROJ.TOM<cr> 


MOD2, MOD3) &< r- 


CREATE -F3:TOMS.LIB<cr> 
:FO:USER.LIB<cr> 


DELETE SFZ:USER.LIB(TEMP1, &<cr> 
TEM TMP, TEST?) <cr> 


DELETE :FO:IO.LIBCFLOPPY, CRT, &<cr> 
SEIPAPER TAPE) <cr> 


EXIT BEXIT<cr>| 
> 
LIST MLIST USER. LIB<cr> 
USER.LIB 
TEMP 
TEST 
EXEC 
MAIN 
LOOP 
MLIST USER. LIB(TENE, TEST) <cr>} 
USER.LIB 
TEMP 
TEST 
MLIST USER.LIB,TEMP.LIB<cr> 
USER.LIB 


MODULETC 
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Comments 


lf SEG1 is byte alignable, it will be located at 15FFH. 
lf SEG2 is byte or word alignable, it will be at 4F5AH. 


Address assignment of groups, segments, and 
classes can be in any order, unless they are 
absolute. 


A long jump to GO will be placed at location 
OFFFFOH. 


The initialization code is placed at address 32768 
decimal (8000H). 


No initialization code will be produced. 


LINES is the default, so it need not be specified. 


This statement removes all debug records from the 
object file, but keeps the information in the print file. 


NOPUBLICS is implied by PURGE, but PUBLICS 
overrides it. 


SEG@A of CLASS1 will be the first relocatable 
segment located. SEG@B will be. next, followed 
immediately by any other segments contained within 
CLASS1. The extra segments in CLASS1 (and all of 
the segments in CLASS2) are located in the order in 
which they are encountered. Finally, the list in the 
SEGMENTS subcontrol is handled. 


Control 
ADDRESSES 


BOOTSTRAP 


COMMENTS/NOCOMMENTS 


INITCODE/NOINITCODE 


LINES/NOLINES 


MAP/NOMAP 


NAME 


OBJECTCONTROLS 


ORDER 


SERIES tt! LOC86 EXAMPLES 


Examples 


mALOC8G6 :F7:COME.LNK TO :F&8:WENT &<er> 
PPAADDRESSES(CSEGMENTS(SEGIA\CLASS2\ && «2 
PRAOVERLAY3SCISFFH), SEG2C4FSAH)) <er> 


MALOC86 :F8:IST.LLNK TO LOCIST.RDY &<cr> 
PRAADDRESSESCSEGMENTSCSEGIACLASS1 &<cre 
a2 3H) ), GROUPS(CGROUPC(O0H) ,DGROLFE s-iv> 
aC i0000K)), CLASSES(MEMORY(15000Fi 0 tcc? 


mLOC86 ss F3:TEST.LNK START(GO) &X<cr> 
PPABOOTSTRAP<cr> 


7F1sSOURCE.LNK NOCOMMENTS<cr> 


:FY:TEMP.LNK COMMENTS<cr> 


mLOC86 :FI:FORK.LNK INITCODE(32768)<c > 


:FITSTEST.UNK NOINITCODE<cr> 


maLOC86 :F1:RUN.LNK NOLINES<cr> 


maLOC86 : FI: TEST. LNK<cr> 
mLOC86 :FI:TESTER.LNK MAP<cr> 


LOC86 :F3:GONE.LNK TO &<cr> 
pa FOSHERMAF.OVY NOMAP<cr> 


maLOC8S& sF4:SHORT.LNK NAME &X<cr> 
PBSC THIS IS A VERY LONG: MODULE@NAME.)<cr> 


LOC86 :F1:UPWARD.LNK &<cr> 
POSOBJECTCONTROLS (NOLINES, &¥<cr> 
PPINOCOMMENTS, NOSYMBOLS)<cr> 


mLOCB6 :F3:PASCLI.LNK &¥<cr> 
PPAOBJECTCONTROLS (PURGE,PUBLICS)<cr> 


maLOC86 sFO:SPCSEQ.LNK ORDER &¥<cr> 


MAC CLASSES(CCLASSI(CSEGGA,SEGGB), &<cr> 
yaCLASS2) ,SEGMENTSCSEGT\CLASS3 &K<cr> 
\OVERLAY1,SEG22,SEGIO\CLASS5) )<cr> 
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Comments 


The print file is :F1:TEMP.MP2. 


The print file is :F5:INTERPL.MP2. 
The print file is :F1:MAP. 


Information about line numbers is removed from the 
print file. 


All but the segment information is removed from the 
print file. 


No public information is included in the output files 
(:F7:PRIVAT.MP2 and :F7:PRIVAT). 


All public symbol information will be included in both 
the print file and output file. 


The object file contains no public or debug informa- 
tion, and the symbol table does not appear in the 
print file. 


The line and symbol information will be kept in the 
print file and object file. 


This control reserves the high order 64K of memory. 
A 200H and a 100H section of memory at the top and 
bottom of memory are reserved. 


The size of segment MEMORY will be increased by 
2000 bytes. 


The size of segment FREUD will be decreased by 
511 bytes. 


The new segment size for XENDA is 7770 bytes. 


:F9:AUTO will start at IGNITION. 

:F7:HALTS will start at location 200H. 

This statement will include the local symbol records 
in the object file and the symbol information in the 
print file. 


PURGE is a_ shorthand for NOSYMBOLS, 
NOCOMMENTS, NOPUBLICS, and NOLINES. 


The symbol table will be printed on a line printer. A 
line printer line can hold a four-column symbol table. 


Control 
PRINT/NOPRINT 


PRINTCONTROLS 


PUBLICS/NOPUBLICS 


PURGE/NOPURGE 


RESERVE 


SEGSIZE 


START 


SYMBOLS/NOSYMBOLS 


SYMBOLCOLUMNS 


SERIES It! LOC86 EXAMPLES 


Examples 


maLOC86 :F1:PROG.LNK TO &<cr> 
pea FLT TEMPT.TST PRINT <cr> 


maLOC86 sFS:INTERP.LNK<cr> 


maLOC86 :F4:PROG.LNK PRIN™@C2F1:MAP) <cr> 


maLOC86 :FI:LINEAR.LNK &¥<cr> 
PRaPRINTCONTROLS(NOLINES) <cr> 


maLOC86 :F7:PRIVAT.LNK NOPUBLICS<cr> 


>FOSTEXT.LLNK NOPUBLICS &<cr> 
pmAaPUBLICS<cr> 


PALOC86 :F3:PROJ5.LNK PURGE<cr> 


BYLOC86 :F3:LOWMEM.LNK RESERVE &<cr> 


PPACOFOQOQOKH TO OFFFFFH) <cr> 


raLOC86 sF2:HUGOS.LNK RESERVE &¥<cr> . 
Pa OOH TO O200H, OFFFOOH TO OFFFFFH) <cr> 


maLOC86 :FO:GROW.LNK SEGSIZE &<cr> 
aC MEMORY (+2000) )<cr> 


maLOC86 :F1: SHRINK.LNK SEGSIZE &<cr> 
PRaCFREUD(-1FFH)) <cr> 


MaLOC8S sFL:RPLACE.LNK SEGSIZE &¥<cr> 
PRA (XENDA( 7770) )<cr> 


PAL OC 86 


>FO:AUTO.LNK STARTCIGNITION) <cr> 


aL OC86 


maLOC86 GESHTA.LNK SYMBOLS<cr> 


sF7SHALTS.UNK START COOH, 200H) <cr> 


maLOC86 :F3:TEST.LNK PURGE<cr> 


PaLOC8S6 sFI:TEST.UNK SYMBOLCOLUMNS (1)<:7> 


PaLOC86 s FO: LINKED. LNK &¥<cr> 
PPASYMBOLCOLUMNS (4) PRINTC:LP:)<cr> 
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absolute object file formats, A-1 
absolute object modules, 1-2 
AD, 5-3 
address, 
in ADDRESSES control, 5-3 
in ASSIGN control, 2-4 
in INITCODE control, 5-6 
in RESERVE control, 5-16 
ADDRESSES, 5-3 
addressing, 
A, 4-2 
absolute, 1-4, 2-4 
ADD, 4-2 
8086, 1-5 
relative, 1-4 
alignment, 
boundaries, 1-8 
of segments, 1-7 
AR, 2-5 
AS, 2-4 
ASSIGN, 2-4 
available memory, effect of, C-1 


BI, 2-6 

BIND, 2-6 

BOOTSTRAP, 5-4 

bound modules (see LTL modules) 
BS, 5-4 


C, 4-3 
class, 8086, 1-9 
CLASSES, 5-3, 5-11 
class name, 
in ADDRESSES control, 5-3 
in ORDER control, 
LINK86, 2-15 
LOC86, 5-11 
in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
CM, 2-7 
COMMENTS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
inPRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86 control, 2-7 
LOC86 control, 5-5 
control summary, 
CREF86, E-1 
LIB86, F-1 
LINK86, D-1 
LOC86, G-1 
CREATE, 4-3 
CREF86, 
controls, 
PAGELENGTH, 3-3 
PAGEWIDTH, 3-4 


PRINT, 3-5 
TITLE, 3-6 
control summary, 3-2 
error messages, E-1 
in development process, 1-1 
input, 3-1 
invocation, 3-2 
output, 3-1 
print file, 3-7 
Series III invocation examples, I-23/I-24 
use Of libraries, 1-3 
cross-reference listing, 3-7 
CS, 5-3, 5-11 


D, 4-3 

data records, 8086, A-3 

debug records, 
LINK86, 2-21 
LOC86, 5-15 

DELETE, 4-3 


E, 4-4 
ENDREC, A-7 
error messages, 
CREF86, E-1 
LIB86, F-1 
LINK86, D-2 
LOC86, G-2 
OH86, H-1 
examples, Series III, 
invocation, 
CREF86, I-23/1-24 
LIB86, I-25/1-26 
LINK86, I-17/I-18 
LOC86, I-27/1-28 
OH86, I-15 
program development, 
CREF86, 1-6 
LIB86, I-7 
LINK86, I-2, I-5, 1-8, I-11, I-14 
LOC86, I-4, I-5, I-8, I-12 
EXIT, 4-4 
external references, 
cross-reference listing, 3-7 
definition of, 1-2 
resolution of, 1-3 


FASTLOAD, 2-8 
FL, 2-8 


GR, 5-3 
group, 
addressing, 1-9 
8086, 1-9 
group map, 2-27 
group name, 
in ADDRESSES control, 5-3 
in LINK86 ORDER control, 2-15 
in LINK86 RENAMEGROUP control, 2-22 
GROUPS, 5-3 
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hexadecimal-decimal conversion, B-1 
hexadecimal object file format, 
conversion to, 6-1 
records of, 
data, A-13 
end of file, A-15 
extended address, A-12 
start address, A-14 


IC, 
LINK86, 2-9 
LOC86, 5-6 

INITCODE, 
LINK86, 2-9 
LOC86, 5-6 

initialization code, 
LINK86, 2-9 
LOC86, 5-6 

input list control, 2-20 


L, 4-6 
LHEADR, A-6 
LI, 
LINK86, 2-10 
LOC86, 5-7 
LIB86, 
commands, 
ADD, 4-2 
CREATE, 4-3 
DELETE, 4-4 
EXIT, 4-5 
LIST, 4-6 
command summary, 4-1, F-1 
error messages, F-1 
in development process, 1-1 
input, 4-1 
invocation, 4-1 
Series III invocation examples, 1-25/1-26 
librarian (see LIB86) 
libraries, 
adding to, 4-2 
creating, 4-3 
deleting from, 4-4 
listing contents of, 4-6 
use of by CREF86, 1-3 
use of by LINK86, 1-3 
line number control, 
LINK86, 2-10 
LOC86, 5-7 
LINES, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
link map, 2-27 
linkage (see LINK86) 
LINK86, 
and LOC86, 1-4 
controls, 
ASSIGN, 2-4 
ASSUMEROOT, 2-5 
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BIND, 2-6 
COMMENTS, 2-7 
FASTLOAD, 2-8 
INITCODE, 2-9 
LINES, 2-10 
MAP, 2-11 
MEMPOOL, 2-12 
NAME, 2-13 
NOBIND, 2-6 
NOCOMMENTS, 2-7 
NOFASTLOAD, 2-8 
NOLINES, 2-10 
NOMAP, 2-11 
NOOVERLAY, 2-16 
NOPRINT, 2-17 
NOPUBLICS, 2-19 
NOPURGE, 2-21 
NOSYMBOLS, 2-24 
NOTYPE, 2-26 
OBJECTCONTROLS, 2-14 
ORDER, 2-15 
OVERLAY, 2-16 
PRINT, 2-17 
PRINTCONTROLS, 5-12 
PUBLICS, 2-19 
PUBLICSONLY, 2-20 
PURGE, 2-21 
RENAMEGROUPS, 2-22 
SEGSIZE, 2-23 
SYMBOLCOLUMNS, 2-25 
SYMBOLS, 2-24 
TYPE, 2-26 
control summary, 2-2, D-1 
error messages, D-2 
in development process, 1-1 
input, 1-4, 2-1, 2-20 
invocation, 2-1 
output, 1-4, 2-1 
print file, 2-27 
segment combination, 1-7 
Series III invocation examples, I-17/1-18 
use of libraries, 1-3 
LIST, 4-6 
load-time-locatable module (see LTL module) 
location (see LOC86) 
location algorithm, 
for modules with overlays, 5-25 
for segments, 5-24 
LOC86, 
and LINK86, 1-4 
controls, 
ADDRESSES, 5-3 
BOOTSTRAP, 5-4 
COMMENTS, 5-5 
INITCODE, 5-6 
LINES, 5-7 
MAP, 5-8 
NAME, 5-9 
NOCOMMENTS, 5-5 
NOINITCODE, 5-6 
NOLINES, 5-7 
NOMAP, 5-8 
NOPRINT, 5-12 
NOPUBLICS, 5-14 
NOPURGE, 5-15 
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NOSYMBOLS, 5-19 
OBJECTCONTROLS, 5-10 
ORDER, 5-11 
PRINT, 5-12 
PRINTCONTROLS, 5-13 
PUBLICS, 5-14 
PURGE, 5-15 
RESERVE, 5-16 
SEGSIZE, 5-17 
START, 5-18 
SYMBOLS, 5-19 
SYMBOLCOLUMNS, 5-19 
control summary, 5-2, G-1 
error messages, G-2 
in development process, 1-1 
input, 1-4, 5-1 
invocation, 2-1 
output, 1-4, 5-1 
print file, 5-21 
Series II] invocation examples, I-27/I-28 
LTL controls, 
BIND, 2-6 
FASTLOAD, 2-8 
MEMPOOL, 2-12 
ORDER, 2-15 
PRINTCONTROLS, 2-18 
SEGSIZE, 2-23 
SYMBOLCOLUMNS, 2-25 
LTL modules, 1-2, 1-4, 1-10 


MA, 
LINK86, 2-11 
LOC86, 5-8 
MAP, 
LINK86, 2-11 
LOC86, 5-8 
maximum-size, 
in MEMPOOL control, 2-12 
in SEGSIZE control, 2-23 
memory, 
configuration with overlays, 1-10 
8086, 1-5 
memory map, 5-23 
memory requirements controls, 
LINK&86 MEMPOOL, 2-12 
SEGSIZE, 
LINK86, 2-23 
LOC86, 5-17 
MEMPOOL, 2-12 
minimum-size, 
in MEMPOOL control, 2-12 
in SEGSIZE control, 2-23 
MODEND, A-9 
module attributes, A-2 
module identification, A-2 
module name, 
in LINK86 NAME control, 2-13 
in LOC86 NAME control, 5-9 


MP, 2-12 

NA, 
LINK86, 2-13 
LOC86, 5-9 

NAME 
LINK86, 2-13. 
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LOC86, 5-9 
naming output module, 
LINK86, 2-13 
LOC86, 5-9 
NOBI, 2-6 
NOBIND, 2-6 
NOCM, 2-7 
NOCOMMENTS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-7 
LOC86, 5-5 
NOFASTLOAD, 2-8 
NOFL, 2-8 
NOIC, 5-6 
NOINITCODE, 5-6 
NOLI, 
LINK86, 2-10 
LOC86, 5-7 
NOLINES, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-10 
LOC86, 5-7 
NOMA, 
LINK86, 2-11 
LOC86, 5-8 
NOMAP 
LINK86, 2-11 
LOC86, 5-8 
NOOV, 2-16 
NOOVERLAY, 2-16 
NOPL, 
LINK86, 2-19 
LOC86, 5-14 
NOPR, 
LINK86, 2-17 
LOC86, 5-12 
NOPRINT, 
LINK86, 2-17 
LOC86, 5-12 
NOPU, 
LINK86, 2-21 
LOC86, 5-15 
NOPUBLICS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-19 
LOC86, 5-14 
NOPURGE, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 


Index-3 


Index 


in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-21 
LOC86, 5-15 
NOSB, 
LINK86, 2-24 
LOC86, 5-19 
NOSYMBOLS, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-24 
LOC86, 5-19 
NOTY, 2-26 
NOTYPE, 
in OBJECTCONTROLS, 2-14 
in PRINTCONTROLS, 2-18 
LINK86, 2-26 


OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
object module format, 1-4, A-1 
oc, 
LINK86, 2-14 
LOC86, 5-10 
OD, 
LINK86, 2-15 
LOC86, 5-11 
offset, 5-18 
OH86, 
error messages, H-1 
in development process, 1-1 
input, 6-1 
invocation, 6-1 
output, 6-1 


Series III invocation example, I-15 


ORDER, 
LINK86, 2-15 
LOC86, 5-11 

OV, 2-16 

OVERLAY, 2-16 

overlay controls, 
ASSUMEROOT,, 2-5 
OVERLAY, 2-16 

overlay, 8086, 1-10 

overlay name, 
ADDRESSES, 5-3 
LINK86 ORDER control, 2-15 


LINK86 OVERLAY control, 2-16 


SEGSIZE, 
~ LINK86, 2-23 
LOC86, 5-17 
overlays and location, 5-25 
OVLDEF, A-7 


PAGELENGTH, 3-3 
PAGEWIDTH, 3-4 
paragraph, 5-18 
pathname, 
in ASSUMEROOT control, 2-5 


Index-4 


in LIB86 commands, 4-1 

in PRINT control, 
LINK86, 2-17 
LOC86, 5-12 


iAPX 86,88 Family Utilities 


in PUBLICSONLY control, 2-20. 


PC, 
LINK86, 2-18 
LOC86, 5-13 
PEDATA, A-10 


performance-memory relationship, C-1 


PIC, 1-10 
PIDATA, A-10 
PL, 
CREF86, 3-3 
LINK86, 2-19 
LOC86, 5-14 
PO, 2-20 


position-independent code (see PIC) 


PR, 
CREF86, 3-5 
LINK86, 2-17 
LOC86, 5-12 
PRINT, 
CREF86, 3-5 
LINK86, 2-17 
LOC86, 5-12 
PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
print file, 
controls, 
CREF86, 3-2 
LINK86, 2-18 
LOC86, 5-13 
CREF86, 


cross-reference information, 3-8 


header, 3-7 

module list, 3-8 

warnings, 3-7 
LINK86, 

error messages, 2-30 

group map, 2-28 

header, 2-27 

link map, 2-11, 2-27 

symbol table, 2-29 
LOC86, 


errors and warnings, 5-24 


memory map, 5-23 
symbol table, 5-21 
print file name, 
LINK86, 2-17 
LOC86, 5-12 
program development, 1-1 
PU, 
LINK86, 2-21 
LOC86, 5-15 
PUBLICS, 
in LIB86 LIST control, 4-6 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-19 


iAPX 86,88 Family Utilities 


LOC86, 5-14 
PUBLICSONLY, 2-20 
public symbol, 1-2, 5-18 
public symbol cross-references, 3-7 
public symbol records, 
in libraries, 4-6 
LINK86, 
PUBLICS/NOPUBLICS, 2-19 
PUBLICSONLY, 2-20 
LOC86, 5-14 
PURGE, 
in OBJECTCONTROLS, 
LINK86, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-21 
LOC86, 5-15 
PW, 3-4 


record formats, 
~ end, A-7 
L-module header, A-6 
module end, A-9 
overlay definition, A-7 
physical enumerated data, A-10 
physical iterated data, A-10 
register initialization, A-8 
R-module header, A-6 
sample, A-4 
T-module header, A-5 
record syntax, A-3 
REGINT, A-8 
register initialization, 2-9, 5-6, A-8 
relocatable object module, 1-2 
relocation (see LOC86) 
RENAMEGROUPS, 2-22 
RESERVE, 5-16 
RG, 2-22 
RHEADR, A-6 
RS, 5-16 


SAMREC, A-4 
SB, 
LINK86, 2-24 
LOC86, 5-19 
SC, 
LINK86, 2-25 
LOC$86, 5-20 
segment, 
alignment, 1-7, 2-28 
combining, 1-8 
8086, 1-6, A-2 
locating, 1-8, 5-24 
memory, 1-8, 2-23, 5-17 
ordering, 
LINK86, 2-15 
LOC86, 5-11, 5-24 
stack, 1-8 


Index 


segment addressability, A-2 
segment location algorithm, 
absolute segments, 5-24 

relocatable segments, 5-25 
segment ordering, 5-24 
segment map, 2-29 
segment name, 
in ADDRESS control, 5-3 
in ORDER control, 
LINK86, 2-15 
LOC86, 5-11 
in SEGSIZE control, 
LINK86, 2-23 
LOC86, 5-17 
SEGMENTS, 5-3 
SEGSIZE, 
LINK86, 2-23 
LOC86, 5-17 
Series III information, 
continuation-line characters, I-1 
environmental considerations, I-1 
ISIS-II conventions, I-1 
program development examples, I-2 
prompts, I-1! 
related publications, I-2 
software version compatibilities, I-1 
size, 5-17 
SM, 5-3, 5-11 
SS, 
LINK86, 2-23 
LOC86, 5-17 
ST, 5-18 
START, 5-18 
start address, 5-4, 5-18 
SYMBOLCOLUMNS, 
LINK86, 2-25 
LOC86, 5-20 
SYMBOLS, 
in OBJECTCONTROLS, 
LINK6, 2-14 
LOC86, 5-10 
in PRINTCONTROLS, 
LINK86, 2-18 
LOC86, 5-13 
LINK86, 2-24 2 
LOC$86, 5-19 
symbol table, 
LINK86, 2-25, 2-29 
LOC86, 5-20, 5-21 


THEADR, A-5 

TITLE, 3-6 

TT, 3-6 

TY, 2-26 

TYPE, 
in OBJECTCONTROLS, 2-14 
in PRINTCONTROLS, 2-18 
LINK86 control, 2-26 

type checking, 2-26 


variable name, 2-4 


Index-5 


aed ® iAPX 86,88 Family Utilities User’s Guide 
i 121616-002 


REQUEST FOR READER’S COMMENTS 


Intel’s Technical Publications Departments attempt to provide publications that meet the needs of all Intel 
product users. This form lets you participate directly in the publication process. Your comments will help 
us correct and improve our publications. Please take a few minutes to respond. 


Please restrict your comments to the usability, accuracy, readability, organization, and completeness of 
this publication. lf you have any comments on the product that this publication describes, please contact 
your Intel representative. If you wish to order BUCICAnOnS: contact the Intel Literature Department (see 
page ii of this manual). 


1. Please describe any errors you found in this publication (include page number). 


2. Does the publication cover the information you expected or required? Please make suggestions for 
improvement. 


3. Is this the right type of publication for your needs? Is it at the right level? What other types of 
publications are needed? 


©, 6 Bs aed teeta RO Pe UME Renee eee enn ens ecm 0 eae Sol teehee es EP OODE cts 
(COU NTRY) 


Please check here if you require a written reply. a 


WE’D LIKE YOUR COMMENTS... 


This document is one of a series describing Intel products. Your comments on the back of this form will 
help us produce better manuals. Each reply will be carefully reviewed by the responsible person. All 
comments and suggestions become the property of Intel Corporation. 


| | NO POSTAGE 


NECESSARY 


IF MAILED 
IN U.S.A. 


BUSINESS REPLY MAIL 


FIRSTCLASS PERMITNO.1040 SANTACLARA,CA 
POSTAGE WILL BE PAID BY ADDRESSEE 


Intel Corporation 

Attn: Technical Publications M/S 6-2000 
3065 Bowers Avenue 

Santa Clara, CA 95051 


B | 
INTEL CORPORATION, 3065 Bowers Avenue, Santa Clara, California 95051 (408) 987-8080 


Printed in U.S.A. 


